This guide provides instructions on testing Apple Pay transactions in the Sandbox environment.
Complete all steps in the following sections.
Prerequisites
iOS device with Apple Pay support.
Sandbox account set up on Apple Pay Payrix Pro test account.
Request a new Apple Sandbox Test Account
Submit a new Partner Services ticket for Product Registration and request your Sandbox test accounts. Provide any additional information or instructions as needed, then send an email with the following information:
Subject: Addition of Sandbox Test Account for Apple Pay Testing
Hello, I would like to add Sandbox Test accounts for Apple Pay. Below are the email addresses I’d like to include for the Sandbox Test accounts that are not associated with existing Apple IDs:
Email 1: …….
Email 2: ……
…
Result: Once each Sandbox test account is created, the associated email will be automatically added to the Apple Developer sandbox environment, where Apple will send an email directly to each account with activation instructions.
Configure your Payment Page with Apple Pay
Once you’ve activated the Apple Developer sandbox environment through their instructions, you can set up your payment page to begin testing.
To set up a payment page for tests:
Configure the Apple Device
After following the Apple Developer activation steps and configuring your PayFields page, you can prepare your Apple iOS device for testing with Apple Pay.
To enable Apple Pay on an Apple iOS device:
Log in to iCloud on your Apple iOS device using your new sandbox account information.
On the iOS device, go to Settings > Apple Pay & Wallet.
Choose and add the cards for testing.
Enable Apple Pay if not already enabled.
Ensure a test payment card is added to the device's Wallet.
Apple Pay & Wallet Test Card Information
The table lists test credit cards that can be used for testing in the Apple Pay wallet on your device.
Note
The displayed test card information won’t work in any other payment environment and is only applicable to Apple Pay & Wallet testing with a valid Apple Developer account.
Card Brand | Card Number | Expiration Date | Security Code |
---|---|---|---|
American Express | 3717 377570 42005 | Any | 1111 |
American Express | 3717 377724 91005 | Any | 1111 |
Discover | 6011 0009 9446 2780 | 11/2024 | 111 |
Discover | 6011 0009 9458 9319 | 11/2024 | 111 |
Mastercard | 5204 2452 5046 0049 | 12/2024 | 111 |
Mastercard | 5204 2452 5052 2095 | 12/2024 | 111 |
Visa | 4761 1200 1000 0492 | 01/27 | 480 |
Visa | 4761 3497 5001 0326 | 01/27 | 982 |
Result: Now that you’ve set up your Apple Pay & Wallet settings for the test cards on your iOS test device, you can perform a test transaction on your payment page to verify your Apple Pay integration is working as expected at checkout.
Perform a Test Transaction
Once your test iOS device is set with the test card information, you can access your online payment page using the device and test your first transaction.
To test your iOS device using a test card:
Open the Payment Page on the iOS device.
Tap the displayed Apple Pay button at checkout.
Select the test card configured in the previous step as the payment method.
Confirm the transaction with Face ID, Touch ID, or your device passcode.
Verify the Result
Once successfully submitted, your transaction will appear with the amount, date, and time through the Portal and will display Apple Pay as the chosen payment method on the Transaction Details page.
To confirm 100% accuracy, review if all transaction data reported for the test Apple Pay transaction in the Portal matches the amount, date, and time of the transaction processed on your payment page.
If a transaction fails, debug your payment page integration to identify potential issues.
To resolve transaction failure issues:
Check the console log for error messages or exceptions.
Fix any issues found and repeat the test as necessary.