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:
Klarna richiede un importo minimo della transazione di $50.01 per comparire 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.
Afterpay richiede un importo minimo della transazione di $50.01 per comparire 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.
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 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 ogni paese, consulta la pagina Europa. Per la documentazione completa sui metodi di pagamento europei, consulta la pagina Europa.

​
Test dei wallet Asia-Pacifico

GCash, Alipay HK, FPS e Touch ‘n Go sono pagamenti tramite codice QR che vengono visualizzati solo quando il paese e la valuta di fatturazione corrispondono.
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 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 generato.
I codici QR in modalità test vengono emessi dall’ambiente di test del provider del wallet e possono comportarsi diversamente da un pagamento live.
Per la documentazione completa, consulta la pagina Asia-Pacifico.

​
Best practice per il testing

Non testare solo i pagamenti riusciti. Testa rifiuti, annullamenti e casi limite come i fondi insufficienti.
Assicurati che i tuoi webhook endpoint elaborino correttamente tutti i tipi di evento, in particolare payment.succeeded, payment.failed e gli eventi delle subscription.Usa 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.
I metodi BNPL richiedono un minimo di $50.01. Verifica che vengano visualizzati o nascosti correttamente in base al totale del carrello.

​
Pagine correlate

Cards

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

Digital Wallets

Testing di Apple Pay, Google Pay e Amazon Pay.

BNPL

Testing di Klarna, Afterpay e Billie.

India

Testing di UPI e dei mandati RBI.

Pix

Testing Pix con CPF di test.

Europe

Testing di iDEAL, Bancontact, EPS e Multibanco.

Asia-Pacific

Testing 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 26 settembre 2026