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

Per simulare un errore, chiudi la finestra modale di Afterpay nella pagina di reindirizzamento. Il pagamento passa da requires_customer_action a requires_payment_method.
Afterpay requires a minimum transaction amount of $50.01 to appear as a payment option.
Per la documentazione completa su BNPL, inclusi i test B2B di Billie, consulta la pagina Buy Now Pay Later.

​
Testare i Digital Wallet

​
Apple Pay

1

Enable test mode

Usa le tue chiavi API di test di Dodo Payments.
2

Add a card to Apple Wallet

Aggiungi una carta reale al tuo Apple Wallet. In modalità di test, la carta non verrà addebitata.
3

Complete test purchase

Apri il checkout su un dispositivo Apple e completa il flusso Apple Pay.
Apple Pay richiede HTTPS. Non verrà visualizzato su localhost senza una configurazione SSL corretta. Anche la verifica del dominio deve essere completata.

​
Google Pay

1

Join the test card group

Unisciti al gruppo di carte di test di Google Pay per aggiungere automaticamente le carte di test al tuo wallet.
2

Enable test mode

Usa le tue chiavi API di test di Dodo Payments.
3

Complete test purchase

Seleziona una delle carte di test in Google Pay per completare la transazione.

​
Amazon Pay, Cash App Pay e RevolutPay

Usa le tue chiavi API di test e segui il flusso di checkout standard. Le transazioni di test sono simulate senza addebiti effettivi. Per la documentazione completa sui Digital Wallet, inclusa la verifica del dominio per Apple Pay, consulta la pagina Digital Wallets.

​
Test ACH Direct Debit

ACH Direct Debit può essere testato in Test Mode inserendo dati bancari di test al checkout.
1

Enable test mode

Usa le tue chiavi API di test di Dodo Payments.
2

Set currency and billing address

Imposta la valuta di fatturazione su USD e il paese dell’indirizzo di fatturazione su US. ACH non è offerto al di fuori di questa combinazione.
3

Use a one-time payment

ACH non è disponibile nei checkout degli abbonamenti, quindi testalo con un pagamento una tantum.
4

Enter the test bank details

Inserisci una delle coppie di numeri di routing e di conto di test riportate di seguito, quindi verifica che il tuo gestore dei webhook riceva lo stato finale del pagamento: i pagamenti ACH vengono confermati in modo asincrono anziché al checkout.

​
Conti bancari di test

Usa il numero di routing 110000000 con uno qualsiasi di questi numeri di conto: Per l’elenco completo dei conti di test, consulta la pagina ACH Direct Debit.

​
Test dei metodi europei

I metodi di pagamento europei (iDEAL, Bancontact, EPS, Multibanco) possono essere testati in Test Mode.
1

Enable test mode

Usa le chiavi API di test di Dodo Payments.
2

Set billing address

Imposta il paese dell’indirizzo di fatturazione in base al metodo di pagamento:
  • NL per iDEAL
  • BE per Bancontact
  • AT per EPS
  • PT per Multibanco
3

Set currency

I metodi europei richiedono la valuta EUR.
4

Complete test flow

Segui il flusso di autenticazione bancaria simulato nell’ambiente di test.

​
IBAN SEPA Direct Debit di test

SEPA Direct Debit richiede EUR e un indirizzo di fatturazione nella zona euro. Usa questi IBAN di test per forzare un risultato specifico: Per l’elenco completo degli IBAN di test, inclusi i valori per ciascun paese, consulta la pagina Europe. Per la documentazione completa sui metodi di pagamento europei, consulta la pagina Europe.

​
Best practice per i test

Non testare solo i pagamenti andati a buon fine. Testa i rifiuti, gli annullamenti e i casi limite, come i fondi insufficienti.
Assicurati che i tuoi endpoint webhook elaborino correttamente tutti i tipi di evento, in particolare payment.succeeded, payment.failed e gli eventi relativi agli abbonamenti.Usa la Dodo Payments CLI per testare i webhook in locale:
  • dodo wh listen inoltra i webhook di test in tempo reale al tuo server locale
  • dodo wh trigger invia payload simulati per tutti i tipi di evento webhook supportati
Per Apple Pay e Google Pay, esegui i test su dispositivi iOS e Android reali. I simulatori non replicano completamente il comportamento dei wallet.
I metodi di pagamento regionali (UPI, iDEAL, ecc.) richiedono indirizzi di fatturazione corrispondenti. Un indirizzo di fatturazione statunitense non mostrerà iDEAL.
I metodi BNPL richiedono un minimo di $50.01. Verifica che vengano mostrati o nascosti correttamente in base al totale del carrello.

​
Pagine correlate

Cards

Test delle carte, 3D Secure e metodi di pagamento salvati.

Digital Wallets

Test di Apple Pay, Google Pay e Amazon Pay.

BNPL

Test di Klarna, Afterpay e Billie.

India

Test di UPI e dei mandati RBI.

Europe

Test di iDEAL, Bancontact, EPS e Multibanco.

Webhooks

Configura i webhook per gli eventi di test.

CLI Webhook Testing

Testa i webhook in locale con la Dodo Payments CLI.
Ultima modifica il 17 agosto 2026