Search

Are you looking for test card numbers?

Would you like to contact support?

Payment-method icon

Enable Apple Pay

Enable Apple Pay on your website or mobile application.

Before you begin

To enable Apple Pay for your customers, you need to have:

If you are using one of our plugins, refer to the specific documentation for enabling Apple Pay:

Process overview

To add the Apple Pay entitlement to your website or mobile application, you need to:

  1. Create a merchant identifier in your Apple developer account, and send the identifier to us.
  2. Enable the Apple Pay capabilities.
  3. Create a payment processing certificate for your merchant identifier, and send the certificate to us so that we can activate it. Apple Pay uses this certificate to encrypt payment information, and we need to have this certificate to be able to decrypt and process the payment.

For web you also need to:

  1. Register and validate your merchant domain with Apple.
  2. Create a merchant identity certificate, convert it to a PEM file, and upload it to your server. This certificate is used to authenticate communication with the Apple Pay servers.

For information about server requirements for Apple Pay on the web, refer to the Apple Developer portal.

Step 1: Create your merchant identifier

  1. Log in to your Apple Developer account at https://developer.apple.com.

  2. Follow the Apple Developer Account Help instructions to create a merchant identifier, but note the following:

    • In the step to enter the merchant description and identifier name, make sure that the identifier includes the prefix merchant.com.adyen. For example: merchant.com.adyen.merchantAccount

      For test accounts, we recommend adding .test to the identifier, for example: merchant.com.adyen.merchantAccount.test.

  3. When you have completed the instructions from Apple, send an email to support@adyen.com with the merchant identifier you entered, and your Adyen web service username (ws@Company.[YourCompanyAccount]).

  4. Save the Certificate Signing Request (CSR) that you will receive from us in reply to your email. You'll use this CSR to create a payment processing certificate.

Step 2: Enable Apple Pay capabilities

  1. Log in to your Apple Developer account at https://developer.apple.com.
  2. Follow the Apple Developer Account Help instructions to enable Apple Pay.

Step 3: Create a payment processing certificate

  1. Log in to your Apple Developer account at https://developer.apple.com.

  2. Follow the Apple Developer Account Help instructions to create a payment processing certificate, but note the following:

    • In the step to select a merchant identifier, make sure you select the merchant identifier you created in Step 1.
    • Skip the step to create a certificate signing request.
    • In the step to select the certificate signing request file, select the CSR you received from us in reply to the email you sent us in Step 1.

    If at any time a question Will payments associated with this Merchant ID be processed exclusively in China? or similar appears, answer No and continue.

    • Download and save the generated payment processing certificate (.cer file).
  3. When you have completed the instructions from Apple, send an email to support@adyen.com with the payment processing certificate you downloaded.

  4. Wait until our Support team confirms that the certificate is activated.

You can now start processing Apple Pay payments in your iOS app. For Apple Pay on the web, you need to do the additional steps described below.

Step 4: Register and validate your merchant domain

This step is only required when you want to enable Apple Pay on the web.

This step doesn't apply when you are using our Salesforce Commerce Cloud plugin.

  1. Log in to your Apple Developer account at https://developer.apple.com.

  2. Follow the Apple Developer Account Help instructions to register a merchant domain, but note the following:

    • In the step to select a merchant identifier, make sure you select the merchant identifier you created in Step 1.

Step 5: Create a merchant identity certificate

This step is only required when you want to enable Apple Pay on the web.

This step doesn't apply when you are using our Salesforce Commerce Cloud plugin.

For each transaction, you need to request an Apple Pay payment session using your Merchant Identity Certificate. In this step, you will create that certificate.

  1. Log in to your Apple Developer account at https://developer.apple.com.

  2. Follow the Apple Developer Account Help instructions to create a merchant identity certificate, but note the following:

    • In the step to select a merchant identifier, make sure you select the merchant identifier you created in Step 1.
    • Follow the instructions from Apple to create a CSR yourself. The CSR you received from us can't be used for creating a merchant identity certificate.
    • Download and save the generated merchant identity certificate (.cer file).
  3. When you have completed the instructions from Apple, add the merchant identity certificate to your keychain.
  4. Export the certificate from your keychain as a p12 file.
  5. Convert the p12 file to a PEM file using the following command:

    openssl pkcs12 -in your-file.p12 -out apple-pay-cert.pem -nodes -clcerts
  6. Upload the apple-pay-cert.pem file to your server.

When requesting an Apple Pay payment session, use the full path to the apple-pay-cert.pem file.