Add a card to Wallet for Apple Pay testing

During a manual iOS session, add an Apple Pay sandbox test card to Wallet to test payment flows without a real card.

This procedure requires Apple Account sign-in, which is available on private and local iOS devices only.

Requirements

  • A device set up for Apple Pay, with a passcode.

  • A Sandbox Apple Account. Create one in App Store Connect. For details, see Apple Pay sandbox testing.

  • A test card from the Test Cards for Apps and the Web list on the same page. Each card has its own expiration date and security code. Cards under Test Cards for Point of Sale Systems can’t be added to Wallet.

  • A device region set to a country or region that supports Apple Pay. American Express test cards also require the United States or United Kingdom region.

Sign in with a Sandbox Apple Account

  1. Start a manual session on the iOS device.

  2. If the device is signed in to another Apple Account, sign out first.

  3. Sign in with the Sandbox Apple Account. For steps, see Sign in to an Apple Account during a manual session.

Add a test card

  1. On the device screen, open Settings, then tap Wallet & Apple Pay.

  2. Under Sandbox, tap Add Card.

    If Sandbox doesn’t appear, the device isn’t signed in with a Sandbox Apple Account.

    The Wallet & Apple Pay screen with Add Card under Sandbox
  3. On the Add to Wallet screen, tap Debit or Credit Card, then tap Continue.

    If Cards Found For You appears, ignore it. Those cards come from other devices signed in to the same account.

  4. Tap Enter Card Details Manually.

  5. Tap Name and type any name.

  6. Tap Card Number, then enter the card number with Input Sensitive Data.

    This field hides the keyboard and the card number from the session stream.

    The Input the sensitive data dialog next to the Card Details screen
  7. Tap ✓ next to Scan Card with Camera.

    The hidden keyboard covers Continue, so tapping Continue has no effect.

  8. Tap Expiration Date and Security Code, and enter each value with Input Sensitive Data. Then tap ✓ next to Scan Card with Camera.

  9. On the Terms and Conditions screen, tap Agree.

    The card network, such as Visa, provides these terms.

  10. If Add to Other Devices appears, tap Add to Other Devices Later.

    This keeps the test card off other devices signed in to the same Sandbox Apple Account.

The card appears under Sandbox in Wallet & Apple Pay. Continue with Use Apple Pay on iOS devices.

The card and the Sandbox Apple Account stay on the device after device cleanup, so later sessions on the same device can use the card without adding it again.

Troubleshoot adding a card

This Card Is Not Eligible for Apple Pay

The card isn’t a valid sandbox test card for this device. Use a card from Test Cards for Apps and the Web, and check that the device region supports Apple Pay.

Invalid Card

The expiration date or security code doesn’t match the card number. Because the session can’t show or clear the hidden fields, tap Add Card Later, then start again from Add Card.