How to Setup Apple Pay Requirements
On this page
- A. Create Apple Developer Account
- B. Create Apple Pay Merchant ID
- C. Verify Your Domain [for web only]
- D. Create Merchant ID Certificate and Private Key [for web only]
- E. Create Payment Processing Certificate
Tip: if you have web-only store and you are enrolling to Apple Developer for only Apple Pay. You can use Apple Pay Web Merchant Registration feature to eliminate all of these requirements. Read more here .
A. Create Apple Developer Account
Go to Apple Developer site to create Apple Developer account, if you do not have any.
B. Create Apple Pay Merchant ID
Sign in to your Apple Developer account, then create Merchant Identifier.
C. Verify Your Domain [for web only]
1- Go to the Merchant ID you created for Apple Pay. Then click add domain as follows:
- Add the domain or subdomain you want to implement Apple Pay on, as follows:
3- You will be redirected to the verify page as the following image, contating two buttons: Download and Verify.
First click download, you will be provided a text file containing the domain association hash, upload it to your server in the specified location: https://mystore.store/.well-known/apple-developer-merchantid-domain-association.txt. Then, make it readable to others, i.e., when you access the link through the browser you get the same provided hash, as follows:
Then click the verify button shown earlier.
4- You will be redirected to the Merchant ID page with your domain having status Verified as follows:
Now your domain is ready to process Apple Pay.
Note: if you get Pending status, make sure to have a valid secure TLS connection and copy the exact text file.
D. Create Merchant ID Certificate and Private Key [for web only]
This section will guide you to create a Merchant Identity Certificate and Private Key through a CertificateSigningRequest file.
1- Go to the Keychain Access app on mac, from the Certificate Assistant choose “Request a Certificate From a Certificate Authority…”
2- Fill your email address, common name, choose “Saved to desk”, then click continue.
3- You will be asked to choose where you want to save the file, choose a folder then save it. The file will be saved with the name “CertificateSigningRequest.certSigningRequest”
4- Go to your Merchant ID on Apple Developer website, in the Apple Pay Merchant Identity Certificate, click Create Certificate button.
5- Click Choose File button, then choose the CertSigningRequest file you saved earlier, then click Continue button.
6- Now you created the certificate in cer format. Download the certificate. The downloaded file name will be “merchant_id.cer”.
7- You will have your certificate information in the Apple Pay Merchant Identity Certificate section as follows:
8- From your computer double click on the downloaded certificate, merchant_id.cer, open Keychain Access app, go to “My Certificates” tab from the login menu on the left, then find your certificate by searching with your Merchant ID, in this tutorial it is “merchant.store.mystore”.
There will be an arrow to the left of your certificate name, click it to expand it, then you will see the private key with a key emoji, in this tutorial it is named “mystore shop”, as follows:
9- Right click on the key then choose “Export “mystore shop”…”
10- Save the file with the right format “p12”
11- Choose Import Password for the file, store it somewhere because you will need it later, then click Ok. You will be then asked to enter your mac user password or fingerprint, complete it.
12- Now you only need to create the certificate and private key in PEM format to use them for Apple Pay requests. From your terminal, make sure you are in the folder that you saved Certificates.p12 in. Then perform this command
openssl pkcs12 -in Certificates.p12 -out ApplePay.crt.pem -clcerts -nokeys
13- Enter the Import Password you chose when creating your p12 file from Keychain Access app. When this step is completed, you will have new certificate file named ApplePay.crt.pem.
14- Perform the following command to create your private key in PEM format
openssl pkcs12 -in Certificates.p12 -out ApplePay.key.pem -nocerts
It will ask you to enter the Import Password, then enter a new Passphrase. Store your passphrase somewhere safe.
The newly created ApplePay.crt.pem and ApplePay.key.pem will be used later for Merchant Validation step.
E. Create Payment Processing Certificate
This is the last step of the setup. Please follow this guide for an easy setup for this certificate.
Last Modified : Dec 2021