Skip to main content
Usa le credenziali di test in questa pagina per simulare pagamenti riusciti, rifiutati e non riusciti in modalità test. Non viene trasferito denaro e nessun account reale viene addebitato. Per vedere un pagamento di test completo, guarda questo video.

Full API Access

Ogni API endpoint è disponibile in modalità test.

Webhook Testing

I webhook vengono attivati per le transazioni di test nello stesso modo che in produzione.
Le credenziali di test funzionano solo in modalità test. In modalità live, un pagamento effettuato con una credenziale di test non va a buon fine.

​
Carte di test

Usa questi numeri di carta per simulare pagamenti riusciti e rifiutati in diverse regioni.
Per tutte le carte di test, usa la data di scadenza 06/32 (oppure 12/34) e il CVV 123.

​
Test degli errori di rinnovo

1

Create a test subscription

Crea una subscription con le tue chiavi API di test usando una carta di test per i pagamenti riusciti (ad esempio, 4242424242424242). L’addebito iniziale dovrebbe andare a buon fine e la subscription dovrebbe diventare attiva.
2

Update the payment method

Apri il Customer Portal, trova la subscription e fai clic su Update Payment Method. Inserisci la carta di test per i pagamenti non riusciti 4000000000000341 (scadenza: 12/34, CVV: 123) e salvala.
3

Advance the next billing date (optional)

Per attivare immediatamente il rinnovo invece di attendere il normale ciclo di fatturazione, usa l’API Update Subscription per impostare next_billing_date sull’ora UTC corrente, sostituendo il valore di esempio riportato di seguito. Il valore deve essere un timestamp UTC ISO 8601 / RFC 3339 (il suffisso Z è obbligatorio).
Consulta la documentazione di riferimento dell’API Update Subscription per maggiori dettagli.
4

Verify the failure

Al successivo tentativo di fatturazione:
  • L’addebito del rinnovo viene rifiutato sulla carta per i pagamenti non riusciti
  • La subscription passa prima a Past Due (il periodo di tolleranza; il webhook subscription.past_due contiene past_due_ends_at), quindi passa a On-Hold al termine del periodo di tolleranza
  • Viene inviato un evento webhook payment.failed
  • Il cliente può tornare al Customer Portal per aggiornare il metodo di pagamento e riprovare

​
Test UPI

Il testing UPI utilizza identificativi VPA (Virtual Payment Address) speciali che simulano diversi risultati del pagamento.

​
Requisiti per il testing UPI

  • Il paese di fatturazione deve essere impostato su IN
  • La valuta deve essere INR
  • Per i merchant non indiani: Adaptive Currency deve essere abilitato
Per la documentazione UPI completa, inclusi i test dei mandati RBI per le subscription, consulta la pagina Metodi di pagamento in India.

​
Test Pix

Il testing Pix utilizza un CPF di test (codice fiscale brasiliano) per simulare il flusso del codice QR.

​
Requisiti per il testing Pix

  • Il paese di fatturazione deve essere impostato su BR
  • La valuta deve essere BRL
Inserisci il CPF di test quando richiesto al checkout. Viene generato un codice QR di test: esegui la scansione con la normale fotocamera del telefono (non è necessaria un’app Pix) e verrai reindirizzato a una pagina di test in cui potrai simulare la transazione come riuscita o non riuscita. Per la documentazione Pix completa, consulta la pagina Pix.

​
Test BNPL

I provider Buy Now Pay Later hanno requisiti specifici per i dati di test.

​
Dati di test Klarna

Usa questi dati per simulare i pagamenti Klarna in modalità test:
Nei checkout in USD, Klarna richiede un importo minimo della transazione di $50.01 per essere visualizzato come opzione di pagamento.

​
Testing Afterpay

1

Select Afterpay

Scegli Afterpay come metodo di pagamento al checkout e fai clic su Pay.
2

Test successful payment

Usa un indirizzo email e un indirizzo di spedizione validi qualsiasi per i pagamenti riusciti.
3

Test failed authentication

Per simulare un errore, chiudi la finestra modale Afterpay nella pagina di reindirizzamento. Il pagamento passa da requires_customer_action a requires_payment_method.
Nei checkout in USD, Afterpay richiede un importo minimo della transazione di $50.01 per essere visualizzato come opzione di pagamento.
Per la documentazione BNPL completa, inclusi i test B2B di Billie, consulta la pagina Buy Now Pay Later.

​
Test dei portafogli digitali

​
Apple Pay

1

Enable test mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e usa le chiavi API create in modalità test. Consulta Test Mode vs Live Mode.
2

Add a card to Apple Wallet

Aggiungi una carta reale al tuo Apple Wallet. In modalità 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 apparirà su localhost senza una configurazione SSL corretta. Anche la verifica del dominio deve essere completata.

​
Google Pay

1

Join the test card group

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

Enable test mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e usa le chiavi API create in modalità test. Consulta Test Mode vs Live Mode.
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 vengono simulate senza addebiti effettivi. Per la documentazione completa sui portafogli digitali, inclusa la verifica del dominio per Apple Pay, consulta la pagina Portafogli digitali.

​
Test ACH Direct Debit

ACH Direct Debit può essere testato in modalità test inserendo i dati bancari di test al checkout.
1

Enable test mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e usa le chiavi API create in modalità test. Consulta Test Mode vs Live Mode.
2

Set currency and billing address

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

Use a one-time payment

ACH non è disponibile nei checkout delle subscription, 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 seguito, quindi conferma che il tuo webhook handler riceva lo stato finale del pagamento: i pagamenti ACH vengono confermati in modo asincrono, non 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 modalità test.
Multibanco mostra un voucher invece di un flusso bancario. Consulta Test Multibanco.
1

Enable test mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e utilizza le chiavi API create in modalità di test. Consulta Test Mode vs Live Mode.
2

Set billing address

Imposta il Paese dell’indirizzo di fatturazione in modo che corrisponda 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 simulato di autenticazione bancaria nell’ambiente di test.

​
Test Multibanco

Utilizza EUR e un indirizzo di fatturazione PT. Dopo aver fatto clic su Pay, il checkout mostra un voucher Multibanco. In modalità di test, il risultato dipende dall’e-mail inserita: Per visualizzare la pagina di successo, utilizza succeed_immediately@example.com, attendi alcuni secondi e tocca Done. Per l’elenco completo delle e-mail di test, consulta la pagina Europe.

​
Test degli IBAN SEPA Direct Debit

SEPA Direct Debit richiede EUR e un indirizzo di fatturazione nella zona euro. Utilizza 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.

​
Test dei wallet dell’Asia-Pacifico

GCash, Alipay HK, FPS e Touch ‘n Go sono pagamenti tramite codice QR che vengono visualizzati solo quando il Paese di fatturazione e la valuta corrispondono.
1

Enable test mode

Disattiva l’interruttore Live Mode nella barra laterale della dashboard e utilizza le chiavi API create in modalità di test. Consulta Test Mode vs Live Mode.
2

Set billing country and currency

Crea un checkout una tantum con la coppia corrispondente:
3

Select the method and confirm

Seleziona il metodo e fai clic su Pay. Un codice QR si apre in una sovrapposizione a schermo intero e il checkout attende il pagamento.
4

Verify the checkout behavior

Verifica che il metodo venga visualizzato solo per il Paese e la valuta corrispondenti e che il codice QR venga visualizzato correttamente.
I codici QR in modalità di test vengono emessi dall’ambiente di test del provider del wallet e possono comportarsi in modo diverso rispetto a un pagamento reale.
Per la documentazione completa, consulta la pagina Asia-Pacific.

​
Best practice per i test

Non testare solo i pagamenti riusciti. Testa i rifiuti, le cancellazioni 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 di sottoscrizione.Utilizza la Dodo Payments CLI per testare i webhook localmente:
  • dodo wh listen inoltra i webhook di test live 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 visualizzerà iDEAL.
Klarna e Afterpay richiedono un minimo di $50.01 per i checkout in USD. Verifica che vengano visualizzati 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.

Pix

Test di Pix con CPF di test.

Europe

Test di iDEAL, Bancontact, EPS e Multibanco.

Asia-Pacific

Test di GCash, Alipay HK, FPS e Touch ‘n Go.

Webhooks

Configurazione dei webhook per gli eventi di test.

CLI Webhook Testing

Test dei webhook localmente con la Dodo Payments CLI.
Ultima modifica il 8 ottobre 2026