Sandbox Testing

Hi,

I set up a Sandbox Tester account in my company’s Apple Developer Program and signed in on my iPhone under Settings → App Store → Sandbox Account.

When I go to Wallet → Add, I only see options for Credit or Debit Card or Travel Card. The option to add an Apple Pay Sandbox Card is missing, and when I try entering the test card numbers from Apple’s documentation (developer.apple.com/apple-pay/sandbox-testing), the card is not valid.

Has anyone experienced this and found a solution? Thanks!

PS: I can't post this to Wallet Category, I keep getting error that it contains sensitive text.

Answered by DTS Engineer in 893971022

Hi @Razee,

You wrote:

[...] When I go to Wallet → Add, I only see options for Credit or Debit Card or Travel Card. The option to add an Apple Pay Sandbox Card is missing, and when I try entering the test card numbers from Apple’s documentation [...]

This is a very common misunderstanding about how Apple Pay Sandbox Testing is set up. The root cause of your issue is that signing in under Settings > App Store > Sandbox Account is for In-App Purchase testing only — it has absolutely no effect on Wallet or Apple Pay.

Apple Pay Sandbox requires the Sandbox Apple Account to be signed in as the primary iCloud account on the device — not as the App Store Sandbox Account. These are two completely separate things:

  • Settings > App Store > Sandbox Account: In-App Purchase (StoreKit) testing only
  • Settings > [Your Name] (primary iCloud): Full device identity including Wallet

As @TapThatApplePay also mentioned, don't do this on your primary personal iPhone — use a dedicated test device to avoid disrupting your personal iCloud data (photos, messages, iCloud Drive, etc.).

Important: The Sandbox Tester email must be a real, unregistered email address that has never been used as an Apple Account before. Using an existing Apple Account email (even a real one) will cause the setup to fail silently.

Cheers,

Paris X Pinkney |  WWDR | DTS Engineer

Hi Razee, I'm going through exactly the same challenge. Did you manage to solve and could you please share? Thanks!

Hey, is this to add a sandbox test card to Apple Wallet?

If so, the Apple ID you created as a developer and added to sandbox in developer portal, needs to be logged into the iPhone. Settings >> name at the top | if that is your AppleId, you'll need to sign out then sign in using the sandbox.

Since it's the main AppleID on the device, we recommend using a test device, not your everyday device as it will wipe the cards when you sign out.

hope this helps

Hi @Razee,

You wrote:

[...] When I go to Wallet → Add, I only see options for Credit or Debit Card or Travel Card. The option to add an Apple Pay Sandbox Card is missing, and when I try entering the test card numbers from Apple’s documentation [...]

This is a very common misunderstanding about how Apple Pay Sandbox Testing is set up. The root cause of your issue is that signing in under Settings > App Store > Sandbox Account is for In-App Purchase testing only — it has absolutely no effect on Wallet or Apple Pay.

Apple Pay Sandbox requires the Sandbox Apple Account to be signed in as the primary iCloud account on the device — not as the App Store Sandbox Account. These are two completely separate things:

  • Settings > App Store > Sandbox Account: In-App Purchase (StoreKit) testing only
  • Settings > [Your Name] (primary iCloud): Full device identity including Wallet

As @TapThatApplePay also mentioned, don't do this on your primary personal iPhone — use a dedicated test device to avoid disrupting your personal iCloud data (photos, messages, iCloud Drive, etc.).

Important: The Sandbox Tester email must be a real, unregistered email address that has never been used as an Apple Account before. Using an existing Apple Account email (even a real one) will cause the setup to fail silently.

Cheers,

Paris X Pinkney |  WWDR | DTS Engineer

Sandbox Testing
 
 
Q