Sandbox Testing

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
• App Store Connect sandbox tester account
• Supported test credentials

Developer Account and Website

To successfully establish an Apple Pay session with Apple Pay servers, your Apple Developer account needs to be configured for Apple Pay. This includes registering a merchant ID, creating certificates, and verifying your website domain if you plan to implement Apple Pay for the web. Make sure to complete the steps below before testing your Apple Pay implementation with Apple Pay 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 (Apple Pay for web only).
• Register and verify a Merchant Domain (Apple Pay for web only).
• Verify that all webpages hosting an Apple Pay button are HTTPS and your web server supports TLS 1.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 Users and Access.
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 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 App Store Connect 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 Apple Pay.

Testing Apple Pay on Your Apps and Websites

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.

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 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.
• 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 Apple Pay 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 Apple Pay 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 Apple Pay and running iOS 11.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 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.

• These are the latest FPANs as of January 2023.

Network	FPANs	MagStripe Contactless	EMV Contactless
Mastercard	5204 2452 5305 0839 Exp Date: 12/2024 CVC: 111	●	●
	5204 2452 5471 8095 Exp Date: 12/2024 CVC: 111	●	●
Visa	4761 1200 1000 0492 Exp Date: 11/2025 CVC: 497	●	●
	4761 3497 5001 0326 Exp Date: 11/2025 CVC: 400	●	●

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.