Översikt
Dodo Payments API tillhandahåller detaljerade orsaker till transaktionsfel för att hjälpa dig förstå varför ett betalningsförsök misslyckades. Dessa felorsaker är standardiserade över olika betalningsmetoder och leverantörer, vilket gör det enklare att implementera konsekvent felhantering i din applikation. Varje svar på ett transaktionsfel inkluderar:- En specifik felkod för misslyckande
- Ett mänskligt läsbart felmeddelande
- Ytterligare kontext om felet när det är tillgängligt
- Om felet kan åtgärdas av användaren eller kräver systemintervention
- Att ge tydlig feedback till dina kunder
- Att implementera lämplig omförsökningslogik
- Att hantera olika felscenarier på ett smidigt sätt
- Att upprätthålla ett pålitligt betalningsbehandlingssystem
Orsaker till transaktionsfel
Följande tabell listar alla möjliga orsaker till transaktionsfel, deras betydelser och om de är användarfel som kan åtgärdas.| Felkod | Användarfel | Beskrivning |
|---|---|---|
AUTHENTICATION_FAILURE | Ja | Autentiseringsprocessen misslyckades under transaktionen |
AUTHENTICATION_REQUIRED | Ja | Ytterligare autentisering behövs för att slutföra transaktionen |
AUTHENTICATION_TIMEOUT | Ja | Autentiseringsprocessen tidsbegränsades |
CARD_DECLINED | Nej | Kortet avslogs av den utfärdande banken |
CARD_NOT_ACTIVATED | Ja | Kortet har inte aktiverats av kortinnehavaren |
CARD_VELOCITY_EXCEEDED | Ja | För många transaktioner har försökt på kort tid |
CUSTOMER_CANCELLED | Ja | Kunden avbröt transaktionen |
DO_NOT_HONOR | Nej | Den utfärdande banken avslog transaktionen |
EXPIRED_CARD | Ja | Kortet har gått ut |
FRAUDULENT | Ja | Transaktionen flaggades som potentiellt bedräglig |
GENERIC_DECLINE | Nej | Transaktionen avslogs av en ospecificerad anledning |
INCORRECT_CVC | Ja | Den angivna CVC-koden var felaktig |
INCORRECT_NUMBER | Ja | Kortnumret angavs felaktigt |
INSUFFICIENT_FUNDS | Ja | Kontot har otillräckliga medel för att slutföra transaktionen |
INVALID_ACCOUNT | Ja | De angivna kontouppgifterna är ogiltiga |
INVALID_AMOUNT | Ja | Transaktionsbeloppet är ogiltigt |
INVALID_CARD_NUMBER | Ja | Formatet på kortnumret är ogiltigt |
INVALID_CARD_OWNER | Ja | Informationen om kortinnehavaren är ogiltig |
INVALID_CVC | Ja | CVC-formatet är ogiltigt |
INVALID_EXPIRY_YEAR | Ja | Utgångsåret för kortet är ogiltigt |
INVALID_PIN | Ja | Den angivna PIN-koden är felaktig |
INVALID_REQUEST | Ja | Transaktionsbegäran innehåller ogiltiga data |
INVALID_UPI_ID | Ja | Den angivna UPI-ID:n är ogiltig |
LIMIT_EXCEEDED | Ja | Transaktionen överskrider kort- eller kontogränsen |
LIVE_MODE_TEST_CARD | Ja | Ett testkort användes i live-läge |
LOST_CARD | Ja | Kortet har rapporterats som förlorat |
MANDATE_INVALID | Ja | Betalningsmandatet är ogiltigt |
MANDATE_REQUIRED | Ja | Ett mandat krävs för denna transaktion |
MANDATE_REQUIRED_SYSTEM | Nej | Systemet kräver ett mandat för denna transaktionstyp |
NETWORK_ERROR | Nej | Ett nätverksfel inträffade under transaktionen |
NETWORK_TIMEOUT | Nej | Nätverksbegäran tidsbegränsades |
ORDER_CREATION_FAILED | Nej | Misslyckades med att skapa beställningen för transaktionen |
PAYMENT_METHOD_PROVIDER_DECLINED | Ja | Betalningsmetodleverantören avslog transaktionen |
PAYMENT_METHOD_UNSUPPORTED | Ja | Betalningsmetoden stöds inte för denna transaktion |
PICKUP_CARD | Ja | Kortet har rapporterats som stulet och bör hämtas |
PROCESSING_ERROR | Nej | Ett fel inträffade under behandlingen av transaktionen |
PROVIDER_UNSUPPORTED | Nej | Betalningsleverantören stöder inte denna transaktionstyp |
REENTER_TRANSACTION | Ja | Transaktionen behöver anges på nytt |
REVOCATION_OF_AUTHORIZATION | Ja | Auktoriseringen för transaktionen återkallades |
STOLEN_CARD | Ja | Kortet har rapporterats som stulet |
TRANSACTION_NOT_ALLOWED | Ja | Transaktionen är inte tillåten för detta kort eller konto |
TRANSACTION_NOT_APPROVED | Ja | Transaktionen godkändes inte |
TRY_AGAIN_LATER | Nej | Transaktionen bör försöka senare |
UNKNOWN_ERROR | Nej | Ett okänt fel inträffade |
Användarfel indikerar huruvida betalningsavvisningen kan lösas av kunden. När
true kan kunden vidta åtgärder för att åtgärda problemet (t.ex. ange korrekta kortuppgifter). När false beror avvisningen på systemnivåproblem eller bankrestriktioner som inte kan lösas av kunden.