> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Testing Process
> Complete guide to testing your Dodo Payments integration with test cards, UPI IDs, BNPL data, and digital wallets.
## Overview
Test mode lets you simulate payments without processing real transactions. All test credentials only work in test mode — never use them in production.
Test transactions don't process actual payments or affect real accounts.
All API endpoints work identically in test and live modes.
Webhooks fire for test transactions just like production.
Test credentials only work in test mode. Attempting to use them in live mode will result in payment failures.
## Test Cards
Use these card numbers to simulate successful and declined payments across different regions.
| 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 |
| Region | Brand | Card Number | Scenario |
| :----- | :--------- | :----------------- | :----------------- |
| US | Visa | `4000000000000002` | Generic decline |
| US | Mastercard | `4000000000009995` | Insufficient funds |
| India | Visa | `4706131211212123` | Generic decline |
| India | Mastercard | `5105105105105100` | Generic decline |
| Card Number | Expiry | CVC |
| :-------------------- | :----- | :-- |
| `4000 0000 0000 0341` | 12/34 | 123 |
Use this card to test subscription Failure renewal, upgrade, and downgrade scenarios.
For all test cards, use expiry date **06/32** (or **12/34**) and CVV **123**.
### How to Test Renewal Failure
Create a subscription with your test API keys using a **success** test card (for example, `4242 4242 4242 4242`). The initial charge should succeed and the subscription should become active.
Open the [Customer Portal](/features/customer-portal), find the subscription you just created, and click **Update Payment Method**. Enter the failure test card `4000 0000 0000 0341` (Expiry: `12/34`, CVC: `123`) and save it as the subscription's payment method.
To trigger renewal immediately instead of waiting for the natural billing cycle, use the Update Subscription API to set `next_billing_date` to the current UTC time. The value must be an ISO 8601 / RFC 3339 UTC timestamp (the `Z` suffix is required).
```http theme={null}
PATCH /subscriptions/{subscription_id}
{
"next_billing_date": "2026-05-03T00:00:00Z"
}
```
See the [Update Subscription API reference](/api-reference/subscriptions/patch-subscriptions#body-next-billing-date-one-of-0) for details.
On the next billing attempt:
* The renewal charge declines on the failure card
* The subscription moves to **On-Hold** status
* A `payment.failed` webhook event is delivered
* The customer can return to the Customer Portal to update the payment method and retry
This card is specifically for testing renewal failures. The charge will decline on the next billing date, allowing you to test payment retry logic, customer notifications, and failure handling.
## 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
For complete UPI documentation including RBI mandate testing for subscriptions, see the [India Payment Methods](/features/payment-methods/india) page.
## 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** | [customer@email.us](mailto:customer@email.us) | [customer+denied@email.us](mailto:customer+denied@email.us) |
| **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
Choose Afterpay as the payment method in checkout and click Pay.
Use any valid email address and shipping address for successful payments.
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.
### Sunbit Testing
Ensure `billing_address.country` is `US` and `billing_currency` is `USD`.
Set the transaction amount between **$60.00 and $19,999.00**.
Select Sunbit at checkout and complete the financing application in the Sunbit modal.
Close the Sunbit modal before completing the flow to simulate a declined application. Payment transitions to `requires_payment_method`.
Sunbit only appears for US customers paying in USD with an amount between **$60.00** and **$19,999.00**.
For complete BNPL documentation including Billie B2B testing, see the [Buy Now Pay Later](/features/payment-methods/bnpl) page.
## Test Digital Wallets
### Apple Pay
Use your Dodo Payments test API keys.
Add a real card to your Apple Wallet. In test mode, the card won't be charged.
Open checkout on an Apple device and complete the Apple Pay flow.
Apple Pay requires HTTPS. It won't appear on `localhost` without proper SSL setup. Domain verification must also be complete.
### Google Pay
[Join the Google Pay test card group](https://groups.google.com/g/googlepay-test-mode-stub-data) to get test cards automatically added to your wallet.
Use your Dodo Payments test API keys.
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](/features/payment-methods/digital-wallets) page.
## Test European Methods
European payment methods (iDEAL, Bancontact, EPS, Multibanco) can be tested in sandbox mode.
Use your Dodo Payments test API keys.
Set the billing address country to match the payment method:
* `NL` for iDEAL
* `BE` for Bancontact
* `AT` for EPS
* `PT` for Multibanco
European methods require EUR currency.
Follow the simulated bank authentication flow in the test environment.
For complete European payment methods documentation, see the [Europe](/features/payment-methods/europe) page.
## Testing Best Practices
Don't just test successful payments. Test declines, cancellations, and edge cases like insufficient funds.
Ensure your webhook endpoints correctly process all event types, especially `payment.succeeded`, `payment.failed`, and subscription events.
Use the [Dodo Payments CLI](/developer-resources/sdks/cli#webhook-testing) to test webhooks locally:
* `dodo wh listen` forwards live test webhooks to your local server
* `dodo wh trigger` sends mock payloads for all 22 event types
For Apple Pay and Google Pay, test on actual iOS and Android devices. Simulators don't fully replicate wallet behavior.
Regional payment methods (UPI, iDEAL, etc.) require matching billing addresses. A US billing address won't show iDEAL.
BNPL methods require \$50.01 minimum. Test that they correctly appear/hide based on cart total.
## Related Pages
Card testing, 3D Secure, and saved payment methods.
Apple Pay, Google Pay, Amazon Pay testing.
Klarna, Afterpay, and Billie testing.
UPI and RBI mandate testing.
iDEAL, Bancontact, EPS, Multibanco testing.
Set up webhooks for test events.
Test webhooks locally with the Dodo Payments CLI.