Skip to main content

​
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 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.
For all test cards, use expiry date 06/32 (or 12/34) and CVV 123.

​
How to Test Renewal Failure

1

Create a test subscription

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.
2

Swap in the failure card via Customer Portal

Open the 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.
3

Advance the next billing date (optional)

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).
See the Update Subscription API reference for details.
4

Verify the failure

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.

​
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 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:
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

För att simulera ett fel stänger du Afterpay-modalens fönster på omdirigeringssidan. Betalningen övergår från requires_customer_action till requires_payment_method.
Afterpay requires a minimum transaction amount of $50.01 to appear as a payment option.
För fullständig BNPL-dokumentation, inklusive Billie B2B-testning, se sidan Buy Now Pay Later.

​
Testa digitala plånböcker

​
Apple Pay

1

Enable test mode

Använd dina test-API-nycklar för Dodo Payments.
2

Add a card to Apple Wallet

Lägg till ett riktigt kort i din Apple Wallet. I testläge debiteras kortet inte.
3

Complete test purchase

Öppna checkout på en Apple-enhet och slutför Apple Pay-flödet.
Apple Pay kräver HTTPS. Det visas inte på localhost utan korrekt SSL-konfiguration. Domänverifieringen måste också vara slutförd.

​
Google Pay

1

Join the test card group

Gå med i testkortsgruppen för Google Pay för att automatiskt lägga till testkort i din plånbok.
2

Enable test mode

Använd dina test-API-nycklar för Dodo Payments.
3

Complete test purchase

Välj ett av testkorten i Google Pay för att slutföra transaktionen.

​
Amazon Pay, Cash App Pay och RevolutPay

Använd dina test-API-nycklar och följ det vanliga checkout-flödet. Testtransaktioner simuleras utan faktiska debiteringar. För fullständig dokumentation om digitala plånböcker, inklusive domänverifiering för Apple Pay, se sidan Digital Wallets.

​
Testa ACH Direct Debit

ACH Direct Debit kan testas i Test Mode genom att ange testbankuppgifter i kassan.
1

Enable test mode

Använd dina test-API-nycklar för Dodo Payments.
2

Set currency and billing address

Ange USD som faktureringsvaluta och landet för faktureringsadressen som US. ACH erbjuds inte utanför denna kombination.
3

Use a one-time payment

ACH är inte tillgängligt i checkouts för prenumerationer, så testa det mot en engångsbetalning.
4

Enter the test bank details

Ange ett av paren med test-routingnummer och kontonummer nedan och bekräfta sedan att din webhook-hanterare tar emot den slutliga betalningsstatusen — ACH-betalningar bekräftas asynkront i stället för i kassan.

​
Testbankkonton

Använd routingnumret 110000000 med valfritt av dessa kontonummer: Se sidan ACH Direct Debit för den fullständiga listan över testkonton.

​
Testa europeiska metoder

Europeiska betalningsmetoder (iDEAL, Bancontact, EPS, Multibanco) kan testas i Test Mode.
1

Enable test mode

Använd dina test-API-nycklar för Dodo Payments.
2

Set billing address

Ange faktureringsadressens land så att det matchar betalningsmetoden:
  • NL för iDEAL
  • BE för Bancontact
  • AT för EPS
  • PT för Multibanco
3

Set currency

Europeiska metoder kräver valutan EUR.
4

Complete test flow

Följ det simulerade bankautentiseringsflödet i testmiljön.

​
Test-IBAN för SEPA Direct Debit

SEPA Direct Debit kräver EUR och en faktureringsadress i euroområdet. Använd dessa test-IBAN för att tvinga fram ett specifikt resultat: Se sidan Europe för den fullständiga listan över test-IBAN, inklusive värden per land. Se sidan Europe för fullständig dokumentation om europeiska betalningsmetoder.

​
Bästa praxis för testning

Testa inte bara lyckade betalningar. Testa avvisningar, avbrutna betalningar och specialfall som otillräckliga medel.
Säkerställ att dina webhook-endpoints behandlar alla händelsetyper korrekt, särskilt payment.succeeded, payment.failed och prenumerationshändelser.Använd Dodo Payments CLI för att testa webhooks lokalt:
  • dodo wh listen vidarebefordrar live-testwebhooks till din lokala server
  • dodo wh trigger skickar simulerade payloads för alla webhook-händelsetyper som stöds
Testa Apple Pay och Google Pay på faktiska iOS- och Android-enheter. Simulatorer återskapar inte wallet-beteendet fullständigt.
Regionala betalningsmetoder (UPI, iDEAL med flera) kräver matchande faktureringsadresser. En faktureringsadress i USA visar inte iDEAL.
BNPL-metoder kräver minst 50,01 USD. Testa att de visas eller döljs korrekt baserat på varukorgens totalsumma.

​
Relaterade sidor

Cards

Korttestning, 3D Secure och sparade betalningsmetoder.

Digital Wallets

Testning av Apple Pay, Google Pay och Amazon Pay.

BNPL

Testning av Klarna, Afterpay och Billie.

India

Testning av UPI- och RBI-mandat.

Europe

Testning av iDEAL, Bancontact, EPS och Multibanco.

Webhooks

Konfigurera webhooks för testhändelser.

CLI Webhook Testing

Testa webhooks lokalt med Dodo Payments CLI.
Senast ändrad 17 augusti 2026