Apple Pay

Configurationanchor

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+ 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 provisioninganchor

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.

Provisioninganchor

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

Step 1anchor

Sign in to your Developer Center in Safari

Step 2anchor

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 3anchor

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
    noteNote: If you are unable to access this information, contact your Control Panel admin. You may need a different Control Panel role.

Step 4anchor

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
    noteNote: You must use the CSR we provide. Do not create a CSR file yourself.

Step 5anchor

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 6anchor

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 renewalanchor

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 1anchor

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 2anchor

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 3anchor

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 4anchor

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 5anchor

Repeat for your production account

Xcode setupanchor

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.


Next Page: Client-side →