Apple Pay Integration Prerequisites

Integration of Apple Pay payment option includes registration of the merchant, verification of the testing domain and testing of the new payment option.

Once the testing of the new payment option is done and verification of the production domain is completed, the payment option is ready to go live.

The dedicated Payment Solution Specialist will be your partner during the integration process.

1. Registration with JPM MPS

The following information must be provided to the Product Solution Specialist prior to starting the registration procedure:

1. Merchant's web shop testing domain.

2. Merchant's legal name that will be shown to consumer in the checkout phase.

2. Verification of the merchant's testing domain on the Apple's side

1. The merchant prepares the domain where the testing environment of the web shop will be hosted and informs the Payment Solution Specialist about the domain.

2. The Payment Solution Specialist provides the merchant with the Apple verification file. The verification file has to be hosted on the testing environment of the web shop where the Apple JavaScript will be hosted and publicly available.

3. Apple verifies the domain and integration process can be continued.

important

Do not modify the verification file provided by the Payment Solution Specialist.

important

The file should be publicly accessible for verification on the testing domain where the webshop will be hosted:

testing_domain.com/.well-known/apple-developer-merchantid-domain-association.rtf

3. Testing Apple Pay on the test environment

The test devices must be enrolled with Apple as the sandbox devices.

To enroll the device, visit https://developer.apple.com/apple-pay/sandbox-testing/

important

Before using the device to test Apple Pay, check whether the device is compatible with Apple Pay: Devices compatible with Apple Pay.

The production device can be used for sandbox testing, but the "Check for Apple Pay” option in Safari settings should be disabled.

info

If you are unable to enroll the test device in Apple Sandbox follow the steps below.

• Create a new email address (that is not used or linked to the existing live user) to be used for sandbox testing as your Apple ID.
• Initial password for the Apple ID.

Register this email on developer.apple.com using the initial password and contact the dedicated Payment Solution Specialist with this information.

3. Integration prerequisites for Production

Before launching to production, another verification file for the production domain has to be verified by Apple.

1. The merchant provides the Payment Solution Specialist with the production domain where the webshop will be hosted.
2. The Payment Solution Specialist provides the merchant with the Apple verification file for production.
3. The merchant hosts the verification file on the production environment of the webshop where the Apple JavaScript will be hosted and publicly available.
4. Apple verifies the production domain, and it is possible to go live.

important

The file should be publicly accessible for verification on the following domain:

production_domain.com/.well-known/apple-developer-merchantid-domain-association.rtf

important

Do not modify the verification file provided by the Payment Solution Specialist.

info

Only VISA and Mastercard are supported Payment options for Apple Pay.

In case the same device is used for testing on both testing and production environment, enable Check for “Apple Pay” option in Safari settings.

Useful links when integrating Apple Pay

Apple Pay on the Web Interactive Demo: Apple Pay on the Web Demo

Acceptable Use Guidelines for Apple Pay on the Web: Acceptable Use Guidelines - Apple Pay on the Web - Apple Developer