Overview
Test mode lets you simulate payments without processing real transactions. All test credentials only work in test mode — never use them in production.No Real Charges
Test transactions don’t process actual payments or affect real accounts.
Full API Access
All API endpoints work identically in test and live modes.
Webhook Testing
Webhooks fire for test transactions just like production.
Test Cards
Use these card numbers to simulate successful and declined payments across different regions.- Successful Payments
- Declined Payments
| Region | Brand | Card Number | Expiry | CVV |
|---|---|---|---|---|
| US | Visa | 4242424242424242 | 06/32 | 123 |
| US | Mastercard | 5555555555554444 | 06/32 | 123 |
| India | Visa | 4576238912771450 | 06/32 | 123 |
| India | Mastercard | 5409162669381034 | 06/32 | 123 |
For all test cards, use expiry date 06/32 and CVV 123.
Test UPI
UPI testing uses special VPA (Virtual Payment Address) identifiers that simulate different payment outcomes.| Status | UPI ID |
|---|---|
| Success | success@upi |
| Failure | failure@upi |
Requirements for UPI Testing
- Billing country must be set to
IN - Currency must be
INR - For non-Indian merchants: Adaptive Currency must be enabled
Test BNPL
Buy Now Pay Later providers have specific test data requirements.Klarna Test Data
Use these details to simulate Klarna payments in test mode:| Field | Approved | Denied |
|---|---|---|
| Date of Birth | 07-10-1970 | 07-10-1970 |
| First Name | Test | Test |
| Last Name | Person-us | Person-us |
| [email protected] | [email protected] | |
| Street | Amsterdam Ave | Amsterdam Ave |
| House Number | 509 | 509 |
| City | New York | New York |
| State | New York | New York |
| Postal Code | 10024-3941 | 10024-3941 |
| Phone | +13106683312 | +13106354386 |
Klarna requires a minimum transaction amount of $50.01 to appear as a payment option.
Afterpay Testing
1
Select Afterpay
Choose Afterpay as the payment method in checkout and click Pay.
2
Test successful payment
Use any valid email address and shipping address for successful payments.
3
Test failed authentication
To simulate failure, close the Afterpay modal window on the redirect page. The payment transitions from
requires_action to requires_payment_method.Afterpay requires a minimum transaction amount of $50.01 to appear as a payment option.
Test Digital Wallets
Apple Pay
1
Enable test mode
Use your Dodo Payments test API keys.
2
Add a card to Apple Wallet
Add a real card to your Apple Wallet. In test mode, the card won’t be charged.
3
Complete test purchase
Open checkout on an Apple device and complete the Apple Pay flow.
Google Pay
1
Join the test card group
Join the Google Pay test card group to get test cards automatically added to your wallet.
2
Enable test mode
Use your Dodo Payments test API keys.
3
Complete test purchase
Select one of the test cards in Google Pay to complete the transaction.
Amazon Pay, Cash App Pay & RevolutPay
Use your test API keys and follow the standard checkout flow. Test transactions are simulated without actual charges. For complete digital wallet documentation including domain verification for Apple Pay, see the Digital Wallets page.Test European Methods
European payment methods (iDEAL, Bancontact, EPS, Multibanco) can be tested in sandbox mode.1
Enable test mode
Use your Dodo Payments test API keys.
2
Set billing address
Set the billing address country to match the payment method:
NLfor iDEALBEfor BancontactATfor EPSPTfor Multibanco
3
Set currency
European methods require EUR currency.
4
Complete test flow
Follow the simulated bank authentication flow in the test environment.
Testing Best Practices
Test all payment scenarios
Test all payment scenarios
Don’t just test successful payments. Test declines, cancellations, and edge cases like insufficient funds.
Verify webhook handling
Verify webhook handling
Ensure your webhook endpoints correctly process all event types, especially
payment.succeeded, payment.failed, and subscription events.Test on real devices
Test on real devices
For Apple Pay and Google Pay, test on actual iOS and Android devices. Simulators don’t fully replicate wallet behavior.
Test regional methods with correct addresses
Test regional methods with correct addresses
Regional payment methods (UPI, iDEAL, etc.) require matching billing addresses. A US billing address won’t show iDEAL.
Verify minimum amounts
Verify minimum amounts
BNPL methods require $50.01 minimum. Test that they correctly appear/hide based on cart total.