Apple Pay

Configuration

Apple Pay leverages a sophisticated cryptographic scheme for passing payment data securely from the Secure Element on the device to Braintree's Vault.
Important
The SSL certificates for all Braintree SDKs are set to expire by June 30, 2025. This will impact existing versions of the SDK in published versions of your app. To reduce the impact, upgrade the iOS SDK to version 6.17.0+Android SDK to version 4.45.0+ or version 5.0.0+ for the new SSL certifications.

If you do not decommission your app versions that include the older SDK versions or force upgrade your app with the updated certificates by the expiration date, 100% of your customer traffic will fail.
Before you can use Apple Pay, you'll need to coordinate a number of identifiers and certificates.

Apple Pay certificate request and provisioningAnchorIcon

In order to use Apple Pay on a real device, you must configure an Apple Pay Merchant ID and an Apple Pay payment processing certificate in Apple's Developer Center.

ProvisioningAnchorIcon

Because our sandbox and production environments are separate, you'll need to complete these steps twice: once for each environment.

Step 1AnchorIcon

Sign in to your Developer Center in Safari

Step 2AnchorIcon

Create an Apple Pay Merchant ID

Note
Note: We recommend using separate Apple Pay Merchant IDs for sandbox and production to ensure that your sandbox app can't create production transactions.

Step 3AnchorIcon

Download your CSR (certificate signing request) from the Control Panel

  1. Click the gear icon in the top right corner, select Processing from the drop-down menu
  2. Scroll to Apple Pay, and click the toggle to enable this payment method
  3. Select the Options link and click the +Add link to download the CSR from the certificate management page
    Note
    Note: If you are unable to access this information, contact your Control Panel admin. You may need a different Control Panel role.

Step 4AnchorIcon

Generate a new Apple Pay payment processing certificate in Apple's developer portal

  1. Select Apple Pay Payment Processing Certificate and click Continue
  2. In the dropdown, choose the Merchant ID you created earlier and click Continue
  3. Under Payment Processing Certificate, click Create Certificate
  4. Answer the prompted question and click Continue
  5. Upload the CSR that you downloaded from the Control Panel in step 3
    Note
    Note: You must use the CSR we provide. Do not create a CSR file yourself.

Step 5AnchorIcon

Download the new Apple Pay payment processing certificate and upload it in the Control Panel

  1. Click the gear icon in the top right corner
  2. Click Processing from the drop-down menu
  3. Scroll to the Payment Methods section
  4. Next to Apple Pay, click the Options link
  5. Next to Apple Merchant Certificates (iOS), click the +Add link

Step 6AnchorIcon

Repeat for your production account.

Note
While you will need to generate and upload a Payment Processing Certificate, a Merchant Identity Certificate is not required to process Apple Pay in-app.

Certificate renewalAnchorIcon

Apple Pay certificates expire after 25 months. To avoid any disruptions in processing, you'll need to generate a new certificate before your current one expires, and upload it to the Control Panel. As with the original request and provisioning, you'll need to complete this process for both sandbox and production.

Step 1AnchorIcon

Download a new Certificate Signing Request (CSR) from the Control Panel


  1. Log into the Control Panel
  2. Click on the gear icon in the top right corner
  3. Click Processing from the drop-down menu
  4. Scroll to the Payment Methods section
  5. Next to Apple Pay, click the Options link
  6. Next to Apple Merchant Certificates (iOS), click the +Add link
  7. Click the Certificate Signing Request link to download the CSR file

Step 2AnchorIcon

Generate a new certificate from Apple


  1. Log into the Apple Developer Portal
  2. Click on Certificates, Identifiers & Profiles, then Identifiers, then select Merchant IDs in the drop-down
  3. Select the appropriate Merchant ID
  4. Under Payment Processing Certificate, click Create Certificate, then click Continue
  5. Upload the CSR file you downloaded from the Control Panel in step 1, and click Continue
  6. Download the new certificate

Step 3AnchorIcon

Upload the new certificate to your Control Panel


  1. Return to the tab with your Control Panel
  2. Under the Upload Certificate section, click the Choose File button
  3. Select the new certificate, and click Upload

Step 4AnchorIcon

Activate the new certificate with Apple


  1. Return to the Apple developer portal and click Edit under the same Merchant ID as before
  2. Click Activate next to the new certificate

Step 5AnchorIcon

Repeat for your production account

Xcode setupAnchorIcon

In Xcode, enable Apple Pay under Capabilities in your Project Settings. Apple,Pay,Xcode,-,Apple,Pay,Capability Then enable both Apple Pay Merchant IDs. Apple,Pay,Xcode,-,Apple,Pay,Merchand,IDs It is important that you compile your app with a provisioning profile for the Apple development team with an Apple Pay Merchant ID. Apple Pay does not support enterprise provisioning.

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more