Apple Pay Integration

Apple Pay is a digital wallet that can be implemented for eCommerce through Payment Extensibility. It allows customers to store their credit card information and provide that information to mobile and web eCommerce stores. When Apple Pay is used to retrieve payment information for an order, the customer receives a confirmation notification on their phone to approve the request.

Validate Website

You must provide your merchant website details to Apple in order to validate your implementation of Apple Pay.

  1. Log into your Apple Pay developer account.
  2. Go to Certificates, Identifiers and Profiles.
  3. Click on Merchant IDs.
  4. Select the Merchant ID for the URL that needs to be validated.
  5. Go to the Merchant Domains section.

    The Merchant Domains section of Apple Pay

  6. Click Add Domain.
  7. Copy the sandbox or production URL and paste into the "Your domain name" field.
  8. Download the apple-developer-merchantid-domain-association.txt file
  9. Log into your sandbox or production eCommerce instance.
  10. Go to Main > Content > Files.
  11. Upload the apple-developer-merchantid-domain-association.txt file.
  12. After the file is uploaded, click on the menu option to get the URL.

    Close-up of the File Manager showing the drop-down option for Get URL

  13. Copy the URL from the CMS to end – ex : cms/files/914bdca4-46b0-4684-a375-5c50e87c6f41
  14. Go to Main > Redirects.
  15. Add a redirect and enable rewrite.
    • Source: .well-known/apple-developer-merchantid-domain-association.txt
    • Target: cms/files/914bdca4-46b0-4684-a375-5c50e87c6f41
  16. Go back to the Apple Developer account screen and click Verify.

Merchant Identity Certificate

This certificate identifies your merchant with Apple Pay and must be submitted in the Payment Gateway Settings menu of eCommerce.

  1. Log into your Apple Pay developer account.
  2. Go to Certificates, Identifiers and Profiles.
  3. Click on Merchant IDs.

    The Merchant IDs page of Apple Pay

  4. Select the Merchant ID for the URL that needs to be validated.
  5. Go to the Apple Pay Merchant Identity Certificate section.

    Close-up of the Apple Pay identify certificate section

  6. Click on Create Certificate.
  7. Follow the instructions provide by Apple.
  8. Once the certificate is created, export the P12 or PFX file from the system.
  9. Convert the P12 or PFX to PEM form containing both a public and private key. You can choose to encrypt the private key with a password.
  10. Copy the contents of the PEM file to the Merchant Identity Certificate field on the Apple Pay Configuration screen.
  11. Enter the password if the private key is encrypted.

Apple Pay Processing Certificate

The Apple Pay Processing Certificate is also referred to as the "Decryption Certificate" in the Payment Gateway Settings menu of eCommerce. You may provide the certificate if you want eComm to decrypt the token and pass it to the processing gateway, but it is not necessary to provide when configuring the Apple Pay adapter.

  1. Log into your Apple Pay developer account.
  2. Go to Certificates, Identifiers and Profiles.
  3. Click on Merchant IDs.
  4. Select the Merchant ID for the URL that needs to be validated.
  5. Go to Apple Pay Payment Processing Certificate.

    The Merchant IDs page of Apple Pay while viewing a specific merchant

  6. Click on Create Certificate.
  7. If using a processing gateway such as Cybersource for processing the Apple Pay token, follow the steps provided by your processing gateway.