Skip to main content
Requires: Apple Developer Program membership ($99/year). Apple Pay setup involves creating a Merchant ID, verifying your domain, and generating two certificates in the Apple Developer Portal.

1. Create a Merchant ID

A Merchant ID identifies you as a merchant who can accept payments via Apple Pay.
  1. Sign in to your Apple Developer Account.
  2. Go to Certificates, Identifiers & Profiles > Identifiers.
  3. Click + to add a new identifier.
  4. Select Merchant IDs.
  5. Enter a description and a unique identifier (e.g. merchant.com.example.yourbusiness).
  6. Click Continue, review, and Register.

2. Verify Your Domain

Apple requires your domain to be verified before Apple Pay can be used on it.
  1. Go back to your Merchant ID page in the developer portal.
  2. Under your Merchant ID, click Edit and then Verify Your Domain.
  3. Enter the domain name (e.g. example.com).
  4. Download the Apple Pay Verification File (apple-developer-merchantid-domain-association).
  5. Upload the file to the .well-known directory on your domain. The full URL should be: https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
  6. Return to the Apple Developer Portal and click Verify.
The file must be served over HTTPS without redirects. Download the file only once. Repeated downloads generate new content.

3. Create Payment Processing Certificate

This certificate is used to handle payment data securely.
  1. Generate a Certificate Signing Request (CSR):
  1. In the Apple Developer Portal, select your Merchant ID.
  2. Under Apple Pay Payment Processing Certificate, click Create Certificate.
  3. Upload your request.csr.
  4. Download the certificate (apple_pay.cer).
  5. Convert to PEM:

4. Create Merchant Identity Certificate

This certificate allows your server to authenticate itself to Apple’s servers.
  1. Generate a CSR and key file:
In the prompt, enter your details. The Common Name should match the one used in the previous step. When asked for a password, leave it blank and press Enter.
  1. In the Apple Developer Portal, select your Merchant ID.
  2. Under Apple Pay Merchant Identity Certificate, click Create Certificate.
  3. Upload your uploadMe.csr.
  4. Download the certificate (merchant_id.cer).
  5. Convert to PEM:

5. Store in PCI Booking

After completing the steps above, you should have these files: When creating the eWallet account in PCI Booking, provide:

Testing

Use Apple Pay Sandbox with test cards in Safari on macOS or iOS.

Next Steps

Payments Library Credentials

Overview of all payment method credentials

Payments Library Overview

Integrate the library in your checkout page