Übersicht
Die Dodo Payments API bietet detaillierte Gründe für Transaktionsfehler, um Ihnen zu helfen, zu verstehen, warum ein Zahlungsversuch fehlgeschlagen ist. Diese Fehlergründe sind über verschiedene Zahlungsmethoden und Anbieter standardisiert, was die Implementierung einer konsistenten Fehlerbehandlung in Ihrer Anwendung erleichtert. Jede Antwort auf einen Transaktionsfehler enthält:- Einen spezifischen Fehlercode
- Eine verständliche Fehlermeldung
- Zusätzlichen Kontext zum Fehler, wenn verfügbar
- Ob der Fehler vom Benutzer behoben werden kann oder eine Systemintervention erfordert
- Klare Rückmeldungen an Ihre Kunden zu geben
- Angemessene Wiederholungslogik zu implementieren
- Unterschiedliche Fehlerszenarien elegant zu handhaben
- Ein zuverlässiges Zahlungssystem aufrechtzuerhalten
Gründe für Transaktionsfehler
Die folgende Tabelle listet alle möglichen Gründe für Transaktionsfehler, deren Bedeutungen und ob es sich um benutzerbehebbare Fehler handelt.| Fehlercode | Benutzerfehler | Beschreibung |
|---|---|---|
AUTHENTICATION_FAILURE | Ja | Der Authentifizierungsprozess schlug während der Transaktion fehl |
AUTHENTICATION_REQUIRED | Ja | Eine zusätzliche Authentifizierung ist erforderlich, um die Transaktion abzuschließen |
AUTHENTICATION_TIMEOUT | Ja | Der Authentifizierungsprozess wurde abgebrochen |
CARD_DECLINED | Nein | Die Karte wurde von der ausstellenden Bank abgelehnt |
CARD_NOT_ACTIVATED | Ja | Die Karte wurde vom Karteninhaber nicht aktiviert |
CARD_VELOCITY_EXCEEDED | Ja | Zu viele Transaktionen wurden in kurzer Zeit versucht |
CUSTOMER_CANCELLED | Ja | Der Kunde hat die Transaktion abgebrochen |
DO_NOT_HONOR | Nein | Die ausstellende Bank hat die Transaktion abgelehnt |
EXPIRED_CARD | Ja | Die Karte ist abgelaufen |
FRAUDULENT | Ja | Die Transaktion wurde als potenziell betrügerisch markiert |
GENERIC_DECLINE | Nein | Die Transaktion wurde aus einem nicht näher spezifizierten Grund abgelehnt |
INCORRECT_CVC | Ja | Der angegebene CVC-Code war inkorrekt |
INCORRECT_NUMBER | Ja | Die Kartennummer wurde falsch eingegeben |
INSUFFICIENT_FUNDS | Ja | Das Konto verfügt über unzureichende Mittel zur Durchführung der Transaktion |
INVALID_ACCOUNT | Ja | Die angegebenen Kontodaten sind ungültig |
INVALID_AMOUNT | Ja | Der Transaktionsbetrag ist ungültig |
INVALID_CARD_NUMBER | Ja | Das Format der Kartennummer ist ungültig |
INVALID_CARD_OWNER | Ja | Die Karteninhaberinformationen sind ungültig |
INVALID_CVC | Ja | Das CVC-Format ist ungültig |
INVALID_EXPIRY_YEAR | Ja | Das Ablaufjahr der Karte ist ungültig |
INVALID_PIN | Ja | Der angegebene PIN ist inkorrekt |
INVALID_REQUEST | Ja | Die Transaktionsanfrage enthält ungültige Daten |
INVALID_UPI_ID | Ja | Die angegebene UPI-ID ist ungültig |
LIMIT_EXCEEDED | Ja | Die Transaktion überschreitet das Karten- oder Kontolimit |
LIVE_MODE_TEST_CARD | Ja | Es wurde eine Testkarte im Live-Modus verwendet |
LOST_CARD | Ja | Die Karte wurde als verloren gemeldet |
MANDATE_INVALID | Ja | Das Zahlungsmandat ist ungültig |
MANDATE_REQUIRED | Ja | Für diese Transaktion ist ein Mandat erforderlich |
MANDATE_REQUIRED_SYSTEM | Nein | Das System verlangt für diesen Transaktionstyp ein Mandat |
NETWORK_ERROR | Nein | Während der Transaktion trat ein Netzwerkfehler auf |
NETWORK_TIMEOUT | Nein | Die Netzwerkanfrage wurde nicht rechtzeitig abgeschlossen |
ORDER_CREATION_FAILED | Nein | Die Bestellung für die Transaktion konnte nicht erstellt werden |
PAYMENT_METHOD_PROVIDER_DECLINED | Ja | Der Zahlungsdienstleister hat die Transaktion abgelehnt |
PAYMENT_METHOD_UNSUPPORTED | Ja | Die Zahlungsmethode wird für diese Transaktion nicht unterstützt |
PICKUP_CARD | Ja | Die Karte wurde als gestohlen gemeldet und muss abgeholt werden |
PROCESSING_ERROR | Nein | Bei der Verarbeitung der Transaktion ist ein Fehler aufgetreten |
PROVIDER_UNSUPPORTED | Nein | Der Zahlungsanbieter unterstützt diesen Transaktionstyp nicht |
REENTER_TRANSACTION | Ja | Die Transaktion muss erneut eingegeben werden |
REVOCATION_OF_AUTHORIZATION | Ja | Die Autorisierung für die Transaktion wurde widerrufen |
STOLEN_CARD | Ja | Die Karte wurde als gestohlen gemeldet |
TRANSACTION_NOT_ALLOWED | Ja | Für diese Karte oder dieses Konto ist die Transaktion nicht erlaubt |
TRANSACTION_NOT_APPROVED | Ja | Die Transaktion wurde nicht genehmigt |
TRY_AGAIN_LATER | Nein | Die Transaktion sollte später erneut versucht werden |
UNKNOWN_ERROR | Nein | Es ist ein unbekannter Fehler aufgetreten |
Benutzerfehler gibt an, ob die Zahlungsablehnung vom Kunden behoben werden kann. Wenn
true, kann der Kunde Maßnahmen ergreifen, um das Problem zu beheben (z. B. korrekte Kartendaten eingeben). Wenn false, liegt die Ablehnung an Systemproblemen oder Bankbeschränkungen, die vom Kunden nicht behoben werden können.