This section describes how to configure the Apple Pay sandbox environment to test your integration before going to production. The Apple Pay sandbox is a testing environment that uses test credit and debit cards to simulate real transactions without actual charges.For more information, refer to the official Apple Pay documentation. Keep in mind that Apple is an external provider, so their documentation and processes may change without prior notice. Prerequisites#
To test in the Apple Pay sandbox environment you need:An iPhone 6 or later (or a device compatible with Apple Pay).
A sandbox account in App Store Connect (see section: Create a Sandbox Account).
The test credentials listed in the sections below.
Create a Sandbox Account in App Store Connect#
Follow these steps to create your sandbox tester account:5.
Click the (+) button to add a new tester.
6.
Fill in the required fields: first name, last name, email address, and password.
7.
Select the country/region.
Use an email address that is not associated with any existing Apple ID account. This email will be your sandbox username.
Adding a Test Card to the Apple Pay Wallet#
Step 1 — Sign out of iCloud on the device#
Apple Pay sandbox requires the device to be signed in with a sandbox tester account, not your production Apple ID.1.
Go to Settings → [your name] (at the top).
2.
Scroll down and tap Sign Out.
3.
Confirm the full iCloud sign out.
You must sign out completely from iCloud. It is not enough to simply switch the App Store account.
Step 2 — Sign in with your sandbox tester account#
1.
Go to Settings → Sign in to your [device].
2.
Enter the email and password of your sandbox tester account (created in App Store Connect).
3.
Complete verification if prompted.
Step 3 — Open the Wallet app#
1.
From the home screen, open the Wallet app.
2.
Tap the + (Add) button in the upper-right corner.
Step 4 — Select the entry method#
1.
Select Debit or Credit Card.
2.
Choose Enter Card Number Manually (instead of using the camera).
Step 5 — Enter the test card details#
Use one of Apple's official test card numbers listed in the Test Cards section.Step 6 — Complete the card registration#
1.
Enter the card number, expiration date, and CVV.
Step 7 — Accept the terms and conditions#
1.
Review and accept the terms.
Step 8 — Verify the card was added#
The card will appear in your Wallet. You can now use it for sandbox test payments.Test cards do not generate real charges.
When finished, sign back in with your production Apple ID.
Apple Pay Test Cards#
The card numbers, CVV/CVC, OTP, and PIN values listed in this section are official test data provided directly by Apple Pay. This data is exclusively for the sandbox environment and does NOT generate real charges.
Mastercard#
| Card Number | Expiration | CVC |
|---|
| 5204 2452 4000 1488 | 01/30 | 111 |
| 5204 2452 4000 1496 | 01/30 | 111 |
| 5204 2452 4000 1504 | 01/30 | 111 |
| 5204 2452 4000 1512 | 01/30 | 111 |
| 5204 2452 4000 1520 | 01/30 | 111 |
Visa#
| Card Number | Expiration | CVV |
|---|
| 4622 9431 2318 0011 | 12/2028 | 111 |
| 4622 9431 2318 0029 | 12/2028 | 222 |
| 4622 9431 2318 0037 | 12/2028 | 333 |
| 4622 9431 2318 0045 | 12/2028 | 444 |
| 4622 9431 2318 0052 | 12/2028 | 555 |
| 4622 9431 2318 0060 | 12/2028 | 666 |
| 4622 9431 2318 0078 | 12/2028 | 777 |
| 4622 9431 2318 0086 | 12/2028 | 888 |
| 4622 9431 2318 0094 | 12/2028 | 999 |
| 4622 9431 2318 0102 | 12/2028 | 000 |
Point of Sale (POS) Test Cards#
These cards are used to test behavior on physical terminals (offline rejection beep):| Card Number | Expiration | CVC |
|---|
| 5204 2452 4000 1009 | 01/30 | 111 |
| 5204 2452 4000 1017 | 01/30 | 111 |
| Card Number | Expiration | CVV |
|---|
| 4622 9431 2318 0003 | 12/2028 | 111 |
| 4622 9431 2318 0110 | 12/2028 | 111 |
Frequently Asked Questions (FAQ)#
Are there special decline codes for Apple Pay transactions?
No, because the transaction travels to the card networks through the same card flow, and the same existing decline codes apply.Are there maximum or minimum transaction amounts?
No, there are no specific amount limits imposed by Apple Pay.Does it work from mobile applications?
No. Currently, the functionality is only available for purchases using web browsers.Does domain registration need to be done in UAT (testing) and Production?
Yes, Apple requires the domain to be validated in both environments in order to process payments correctly.Does 3DS authentication apply to Apple Pay transactions?
Apple Pay transactions do not require 3DS because when the card is registered in the wallet, the process is authorized by the Issuer.Can I use sandbox cards in production?
No. Sandbox cards are exclusively for the Apple Pay test environment. Real cards must be used in production. 