Apple Pay Sandbox Testing

The sandbox environment is a great way to test offline implementation of Apple Pay for apps, websites, and point of sale systems. This document provides an overview of the sandbox environment, details on how to get started, and general support to test your Apple Pay transactions.

Sandbox

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

Note: It is also important to test Apple Pay 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 Apple Pay in the sandbox:

• iPhone 6 or later, iPad mini 3 or later, iPad Air 2, iPad Pro, or Apple Watch
• iTunes Connect sandbox tester account
• Supported test credentials

Create a Sandbox Tester Account

To create a sandbox tester account, follow these steps:

1. Sign in to iTunes Connect.
2. On the homepage, click Users and Roles.
3. Click Sandbox Testers.
4. Select “+” to set up your tester accounts.
5. Complete the Tester Information form and click Save.
6. Sign out of your Apple ID 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 Setting Up User Accounts.

Important: If you mistakenly use a sandbox tester account to sign in to a production environment, like iTunes, on your test device instead of your test environment, the sandbox account becomes invalid and can’t be used again. If this happens, create a new sandbox tester account with a new email address.

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 that supports Apple Pay.

Sandbox Testing

With your iPhone, iPad, or Apple Watch, you can use the Apple Pay sandbox to pay within your app and website. The Apple Pay sandbox environment allows merchants and developers to test Apple Pay 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.

Apple Pay Supported Apps and Websites

1. Click or tap the "Buy with Apple Pay” or “Apple Pay” buttons.
2. Check your billing, shipping, and contact information to make sure they’re correct. If you want to test paying with a different test card, tap > Next to your card.
3. If you need to, enter your billing, shipping, and contact information so you won’t need to enter it again.
4. Place your finger on Touch ID or enter passcode, or for web you can confirm the transaction on your Apple Watch. After your payment information passes successfully, you’ll see a checkmark on the screen.

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 Apple Pay 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.

Test Cards for Point of Sale Systems

Retailers can use the sandbox to do simple terminal offline tests to make sure Apple Pay 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 Apple Pay sandbox environment.

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

Feedback and Questions

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