Sandbox Testing - Apple Pay (2024)

Sandbox

The ApplePay sandbox environment allows merchants and developers to test their implementation of ApplePay with test credit and debit cards. Currently the sandbox supports ApplePay testing for:

Note: It is also important to test ApplePay in your production environment. Real cards must be used in the production environment. Test cards will not work.

Getting Started

You’ll need the following to test ApplePay in the sandbox:

• iPhone 6 or later, iPadmini3 or later, iPadAir2, iPadPro, or AppleWatch
• AppStoreConnect sandbox tester account
• Supported test credentials

Developer Account and Website

To successfully establish an ApplePay session with ApplePay servers, your AppleDeveloper account needs to be configured for ApplePay. This includes registering a merchant ID, creating certificates, and verifying your website domain if you plan to implement ApplePay for the web. Make sure to complete the steps below before testing your ApplePay implementation with ApplePay servers.
Learn more about configuring your environment

• Register a Merchant ID in your developer account.
• Create your Payment Processing Certificate or obtained a CSR from your PSP.
• Create your Merchant Identity Certificate (ApplePay for web only).
• Register and verify a Merchant Domain (ApplePay for web only).
• Verify that all webpages hosting an ApplePay button are HTTPS and your web server supports TLS1.2.

Create a Sandbox Tester Account

To create a sandbox tester account, follow these steps:

1. Sign in to App Store Connect.
2. On the homepage, click UsersandAccess.
3. Under Sandbox, click Testers.
4. Click “+” to set up your tester accounts.
5. Complete the tester information form and click Invite.
6. Sign out of your AppleID on all testing devices and sign back in with your new sandbox tester account.

For more information on how to create a sandbox tester account, see AppStoreConnect Help: Create a sandbox tester account.

Adding a Test Card Number

To get started, add a test card to Wallet:

1. Make sure to sign out of iCloud and sign into your test device with your sandbox tester account.
2. Go to Wallet and tap Add Credit or Debit Card.
3. Using your test credential, follow the steps to add a new card using manual entry.
4. After your card has been added, you may begin testing.

Note: To provision test cards on your device and use the sandbox, you will need to make sure that your device’s region is set to a country or region that supports ApplePay.

Testing Apple Pay on Your Apps and Websites

With your iPhone, iPad, or AppleWatch, you can use the ApplePay sandbox to pay within your app and website. The ApplePay sandbox environment allows merchants and developers to test ApplePay before or after implementation. Developers don’t have to use their personal production cards for testing. Merchants or your PSP can test whether they’re able to decrypt the transaction-specific payment load.

Note: Your sandbox test transaction will decline pre-fulfillment as the test key will not match your production key.

Learn how to use Apple Pay

Test Cards for Apps and the Web

Test card numbers (FPAN, CVV, CVC, Expiration Date) from the payment networks are listed below and can be used on supported devices to test within the ApplePay sandbox environment.

Note:

• FPAN and DPAN expiration dates do not need to match.
• American Express test cards can only support device regions that are set to the United States.
• These are the latest FPANs as of January 2023.

Test Cards for Apps and Websites in China Mainland

Test card details (FPAN, CVV, Expiry, OTP) for China UnionPay cards are listed below and can be used on supported devices to test your ApplePay implementation.

Note:

• China UnionPay test cards can only support device regions that are set to China mainland.
• You will be prompted to enter a One Time Password (OTP) during provisioning. You should enter the value 123456.
• China UnionPay test debit cards do not require CVV or expiry date.
• China UnionPay test cards may require a PIN when making an ApplePay test transaction. The PIN is 939393.
• In China mainland, Apple Pay for websites is available only on Safari on iOS devices that are compatible with ApplePay and running iOS11.2 or later.
• These are the latest FPANs as of September 2022.

Test Cards for Point of Sale Systems

Retailers can use the sandbox to do simple terminal offline tests to make sure ApplePay transactions are working in their PoS terminals before they enable NFC functionality.

Test card numbers (FPAN, CVV, CVC, Expiration Date) from the payment networks are listed below so you can test within the ApplePay sandbox environment.

Note: This does not replace Payment Network contactless certification. These FPANs can only be used for terminal offline beep tests using ApplePay after completing Payment Network certification.

• These are the latest FPANs as of January 2023.

Feedback and Questions

Have feedback? Send it to ApplePay Support. Have additional questions? Join the conversation. Post questions and search for answers at Apple Developer Forums.