Panoramica
L’API di Dodo Payments fornisce motivi di errore di transazione dettagliati per aiutarti a capire perché un tentativo di pagamento non è andato a buon fine. Questi motivi di errore sono standardizzati tra diversi metodi di pagamento e fornitori, rendendo più facile implementare una gestione degli errori coerente nella tua applicazione. Ogni risposta di errore di transazione include:- Un codice di errore specifico
- Un messaggio di errore leggibile dall’utente
- Ulteriori dettagli sull’errore quando disponibili
- Se l’errore è correggibile dall’utente o richiede un intervento del sistema
- Fornire un feedback chiaro ai tuoi clienti
- Implementare una logica di ripetizione appropriata
- Gestire diversi scenari di errore in modo elegante
- Mantenere un sistema di elaborazione dei pagamenti affidabile
Motivi di Errore di Transazione
La seguente tabella elenca tutti i possibili motivi di errore di transazione, i loro significati e se si tratta di errori correggibili dall’utente.| Codice di errore | Errore dell’utente | Descrizione |
|---|---|---|
AUTHENTICATION_FAILURE | Sì | Il processo di autenticazione è fallito durante la transazione |
AUTHENTICATION_REQUIRED | Sì | È necessaria un’autenticazione aggiuntiva per completare la transazione |
AUTHENTICATION_TIMEOUT | Sì | Il processo di autenticazione è scaduto |
CARD_DECLINED | No | La carta è stata rifiutata dalla banca emittente |
CARD_NOT_ACTIVATED | Sì | La carta non è stata attivata dal titolare |
CARD_VELOCITY_EXCEEDED | Sì | Troppi tentativi di transazione in un breve periodo |
CUSTOMER_CANCELLED | Sì | Il cliente ha annullato la transazione |
DO_NOT_HONOR | No | La banca emittente ha rifiutato la transazione |
EXPIRED_CARD | Sì | La carta è scaduta |
FRAUDULENT | Sì | La transazione è stata segnalata come potenzialmente fraudolenta |
GENERIC_DECLINE | No | La transazione è stata rifiutata per un motivo non specificato |
INCORRECT_CVC | Sì | Il codice CVC fornito era errato |
INCORRECT_NUMBER | Sì | Il numero della carta è stato inserito in modo errato |
INSUFFICIENT_FUNDS | Sì | Il conto ha fondi insufficienti per completare la transazione |
INVALID_ACCOUNT | Sì | I dettagli del conto forniti non sono validi |
INVALID_AMOUNT | Sì | L’importo della transazione non è valido |
INVALID_CARD_NUMBER | Sì | Il formato del numero della carta non è valido |
INVALID_CARD_OWNER | Sì | Le informazioni sul proprietario della carta non sono valide |
INVALID_CVC | Sì | Il formato del CVC non è valido |
INVALID_EXPIRY_YEAR | Sì | L’anno di scadenza della carta non è valido |
INVALID_PIN | Sì | Il PIN fornito è errato |
INVALID_REQUEST | Sì | La richiesta di transazione contiene dati non validi |
INVALID_UPI_ID | Sì | L’ID UPI fornito non è valido |
LIMIT_EXCEEDED | Sì | La transazione supera il limite della carta o del conto |
LIVE_MODE_TEST_CARD | Sì | È stata utilizzata una carta di prova in modalità live |
LOST_CARD | Sì | La carta è stata segnalata come smarrita |
MANDATE_INVALID | Sì | Il mandato di pagamento non è valido |
MANDATE_REQUIRED | Sì | È richiesto un mandato per questa transazione |
MANDATE_REQUIRED_SYSTEM | No | Il sistema richiede un mandato per questo tipo di transazione |
NETWORK_ERROR | No | Si è verificato un errore di rete durante la transazione |
NETWORK_TIMEOUT | No | La richiesta di rete è scaduta |
ORDER_CREATION_FAILED | No | Impossibile creare l’ordine per la transazione |
PAYMENT_METHOD_PROVIDER_DECLINED | Sì | Il fornitore del metodo di pagamento ha rifiutato la transazione |
PAYMENT_METHOD_UNSUPPORTED | Sì | Il metodo di pagamento non è supportato per questa transazione |
PICKUP_CARD | Sì | La carta è stata segnalata come rubata e deve essere ritirata |
PROCESSING_ERROR | No | Si è verificato un errore durante l’elaborazione della transazione |
PROVIDER_UNSUPPORTED | No | Il fornitore di pagamento non supporta questo tipo di transazione |
REENTER_TRANSACTION | Sì | La transazione deve essere reinserita |
REVOCATION_OF_AUTHORIZATION | Sì | L’autorizzazione per la transazione è stata revocata |
STOLEN_CARD | Sì | La carta è stata segnalata come rubata |
TRANSACTION_NOT_ALLOWED | Sì | La transazione non è consentita per questa carta o conto |
TRANSACTION_NOT_APPROVED | Sì | La transazione non è stata approvata |
TRY_AGAIN_LATER | No | La transazione deve essere riprovata più tardi |
UNKNOWN_ERROR | No | Si è verificato un errore sconosciuto |
Errore dell’utente indica se il rifiuto del pagamento può essere risolto dal cliente. Quando
true, il cliente può agire per risolvere il problema (ad esempio, inserendo i dettagli corretti della carta). Quando false, il rifiuto è dovuto a problemi a livello di sistema o restrizioni bancarie che non possono essere risolti dal cliente.