Ü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 ist während der Transaktion fehlgeschlagen |
AUTHENTICATION_REQUIRED | Ja | Zusätzliche Authentifizierung ist erforderlich, um die Transaktion abzuschließen |
AUTHENTICATION_TIMEOUT | Ja | Der Authentifizierungsprozess hat zu lange gedauert |
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 storniert |
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 bezeichneten Grund abgelehnt |
INCORRECT_CVC | Ja | Der angegebene CVC-Code war falsch |
INCORRECT_NUMBER | Ja | Die Kartennummer wurde falsch eingegeben |
INSUFFICIENT_FUNDS | Ja | Das Konto hat nicht genügend Guthaben, um die Transaktion abzuschließen |
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 Informationen zum Karteninhaber 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 | Die angegebene PIN ist falsch |
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 | Eine Testkarte wurde im Live-Modus verwendet |
LOST_CARD | Ja | Die Karte wurde als verloren gemeldet |
MANDATE_INVALID | Ja | Das Zahlungsmandat ist ungültig |
MANDATE_REQUIRED | Ja | Ein Mandat ist für diese Transaktion erforderlich |
MANDATE_REQUIRED_SYSTEM | Nein | Das System benötigt ein Mandat für diesen Transaktionstyp |
NETWORK_ERROR | Nein | Während der Transaktion ist ein Netzwerkfehler aufgetreten |
NETWORK_TIMEOUT | Nein | Die Netzwerkanforderung hat zu lange gedauert |
ORDER_CREATION_FAILED | Nein | Die Bestellung für die Transaktion konnte nicht erstellt werden |
PAYMENT_METHOD_PROVIDER_DECLINED | Ja | Der Zahlungsanbieter 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 sollte eingezogen 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 Genehmigung für die Transaktion wurde widerrufen |
STOLEN_CARD | Ja | Die Karte wurde als gestohlen gemeldet |
TRANSACTION_NOT_ALLOWED | Ja | Die Transaktion ist für diese Karte oder dieses Konto 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 | Ein unbekannter Fehler ist aufgetreten |
Benutzerfehler gibt an, ob die Ablehnung der Zahlung 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 systemseitigen Problemen oder Bankbeschränkungen, die vom Kunden nicht behoben werden können.