Apple Pay

Prerequisite
The best way to enable Apple Pay is via Drop-in/LinkPay integration. Once Drop-in / LinkPay is integrated, you can enable Apple Pay via configuration.
Please refer to the Drop-in/LinkPay integration guide:
https://developer.evonetonline.com/docs/drop-in-integration
https://developer.evonetonline.com/docs/linkpay-integration-step

Apple Pay testing must be performed on a HTTPS-enabled domain.
Due to the security requirements from Apple, Apple Pay cannot be tested on local or non-secure environments

Introduction

Apple Pay is a digital wallet and payment service provided by Apple, allowing users to complete fast, secure, and seamless online payments using cards stored in their Apple Wallet.

Credit cards are supported in the Sandbox environment.

Apple provides a Sandbox (UAT) environment that allows merchants to test Apple Pay without using real cards.

Domain Verification (Drop-in Required)

To enable Apple Pay, merchants must complete domain verification:

1. Provide your HTTPS domain to our team for backend configuration.
2. Request the verification file from our team: apple-developer-merchantid-domain-association
3. On your server, create /.well-known/ at the root, and place the file inside.
4. Verify by accessing:
   https://[your-domain]/.well-known/apple-developer-merchantid-domain-association
   As long as Apple's verification crawler can successfully fetch the file, the domain verification will pass, regardless of whether the browser downloads or displays the file.
5. Apple Pay will not be available until domain verification is completed. Required for both Sandbox and Production.

Sandbox Testing

Apple Pay sandbox testing can be done in either of the following ways.

Option 1: Evonet-Assisted Testing (Recommended)

If you prefer not to perform testing on your side, simply provide us with a valid payment QR code after integration.

Our team will complete the Apple Pay sandbox testing on your behalf and confirm the test result with you.

Option 2: Merchant Self-Testing (Optional)

If you would like to test Apple Pay by yourself, you may use the Apple Pay sandbox tester account and test cards below to complete testing on you own device.

Supported Devices

iPhone 6 or later, iPad mini 3, iPad Air 2, iPad Pro or later, Apple Watch with Apple Pay support

System and Region

iOS 18 or above, Device region set to United States or Hong Kong, Network/IP origin must also be from these regions

Sandbox Tester Account

Use the following Apple Sandbox tester account to sign in:

Apple ID: [email protected]
Password: Cil123456

The SMS verification code will be sent to our internal phone number:
... .... ..00
Our team will receive the SMS and share the verifaction code with you to complete the login.

Test Card (Sandbox Only)

Visa

Card Number: 4761 1200 1000 0492
Expiration Date: 01/27
CVV: 480

Card Number: 4123 4000 7332 0224
Expiration Date: 01/27
CVC: 221

Card Number: 4761 2099 8001 1439
Expiration Date: 01/27
CVV: 466

Mastercard

Card Number: 5204 2452 5046 0049
Expiration Date: 01/30
CVC: 111

Card Number: 5204 2452 5052 2095
Expiration Date: 01/30
CVC: 111

Card Number: 5204 2452 5110 7599
Expiration Date: 01/30
CVC: 111

These test cards are virtual cards issued by Apple and are only used for sandbox testing and cannot be used for production. Sometimes, I0015 payment failure may be reported due to Apple Pay Sandbox limitations.

Sandbox Usage (Self-Testing Only)

Before testing Apple Pay, please complete the following steps:

1. Sign in to the test device using an Apple Sandbox Tester account
2. Open Apple Wallet
3. Select Add Card
4. Manually enter one of the Apple Pay Sandbox test cards listed above
5. After the card is successfully added, Apple Pay will be available on the Drop-in/LinkPay payment page for testing

Simplified Reference