Apple Pay Sandbox testing

July 16, 2026

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.

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:

1. Sign in to App Store Connect.
2. Go to Users and Access.
3. Select the Sandbox tab.
4. Click Testers.
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.
8. Click Create.

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.

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.
2. Tap Next.

Step 7 — Accept the terms and conditions

1. Review and accept the terms.
2. Tap Agree or Continue.

Step 8 — Verify the card was added

The card will appear in your Wallet. You can now use it for sandbox test payments.

Apple Pay Test Cards

Mastercard

Visa

Point of Sale (POS) Test Cards

These cards are used to test behavior on physical terminals (offline rejection beep):

Mastercard POS:

Visa POS:

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.