Setting up your Apple Pay Merchant ID in the Expert Back Office
- Your Expert Back Office.
- Your Apple Developer account.
- Your domain server.
To facilitate your setup, make sure you can access the different areas simultaneously.
- Select your created Apple Pay MID in the tab Merchant IDs.
The contract details appear.
- Click on Download a certificate signature request
(.csr) in the section Apple Pay
Payment Processing Certificate.
The gateway provides a CSR file to request the certification of payment processing. This file is downloaded to a local folder on your computer.
- Log into your Apple Pay Developer account to import the downloaded file and then follow these steps to obtain a signed certificate:
- Go to Certificates, Identifiers & Profiles.
- Select Merchant IDs in the App IDs list.
- From the Merchant ID page, go to Apple Pay Payment Processing Certificate.
- Click on Create Certificate.
The certificate creation page appears.
- Click on Choose file then load the downloaded file from your Expert Back Office.
Example: processing.bdupont-1234-apple.csr
- Click on Continue and then on Download on the page that appears.
The signed certificate is generated.
- Save the downloaded certificate locally on your computer.
This certificate is mandatory for processing payments between Apple and the payment gateway.
- Click on Import the certificate signed by Apple
(.cer) in the section Apple Pay
Payment Processing Certificate.
This import button appears as soon as you click on Download a certificate signature request (.csr).
- Upload the downloaded certificate file to perform the import.
Example: processing.bdupont-1234-apple.csr
The Status of the field changes to Certificate enabled.
- Then click on Download a certificate signing request
(.csr) in the section Apple Pay
Merchant Identity Certificate.
The gateway provides a CSR file to request the certification of the merchant’s identity.
The two uploaded files each have a different prefix followed by the merchant ID to help identify the role of each file.
Examples:
processing.bdupont-1234-apple.csr
identity.bdupont-1234-apple.csr
- From your Apple Developer account:
- Go to Certificates, Identifiers & Profiles.
- Select Merchant IDs in the App IDs list.
- From the Merchant ID page, go to Apple Pay Merchant Identity Certificate.
- Click on Create Certificate.
The certificate creation page appears.
- Click on Choose file then load the downloaded file from your Expert Back Office.
Example: identity.bdupont-1234-apple.csr
- Click on Continue and then on Download on the page that appears.
The signed certificate is generated.
- Save the downloaded certificate locally on your computer.
- Click on Import the certificate signed by Apple
(.cer) in the section Apple Pay
Merchant Identity Certificate.
This import button appears as soon as you click on Download a certificate signing request (.csr).
- Upload the downloaded certificate file to perform the import.
Example: identity.bdupont-1234-apple.csr
The Status of the field changes to Certificate enabled.
- To finalize the declaration of the contract, you still need to fill in the domain(s) offering Apple Pay integration to get their validation from Apple.
You must declare all URLs where Apple Pay will be used and these URLS must be https.
- Sign in to your Apple Developer account.
- Select Merchant IDs in the App IDs list.
- Select your Merchant ID (see chapter Creating a merchant ID in Apple Pay Developer)
- Select Add Domain under the Merchant Domain section.
- Fill in your domain name and click save.
- Select Download and save the file apple-developer-merchantid-domain-association.txt obtained.
- Retrieve the downloaded apple-developer-merchantid-domain-association.txt file and create a directory named .well-known at the root of your domain for uploading the file.
In the end, you should have a url like this: https://your-domain.com/.well-known/apple-developer-merchantid-domain-association.txt
- Once the file is placed in the .well-known directory at the root of your domain, return to your Merchant Domain space and click on Verify.
The Apple Pay contract declaration is now complete.