Ablehnungscodes
Stripe Ablehnungscodes: was jeder einzelne bedeutet und wie man ihn behebt
Geprüft am
Stripe Ablehnungscodes sagen Ihnen, warum eine Kartenzahlung bei Stripe fehlgeschlagen ist. Einige stammen von der Bank der Karte, wie `insufficient_funds` oder `expired_card`; einige kommen von Stripe selbst, wie `fraudulent` oder `merchant_blacklist`. Stripe gibt sie als `decline_code` bei einem `card_declined` Fehler zurück. Jede Seite unten erklärt einen Code, sagt, ob ein erneuter Versuch gemäß den Regeln des Kartennetzwerks funktionieren kann, und zeigt, was PlatformDTC Kassen- und Abonnementverlängerungen damit tun.
| Code | Bedeutung |
|---|---|
| authentication_required | Die Bank möchte, dass der Karteninhaber die Zahlung verifiziert, normalerweise mit 3D Secure. |
| authentication_not_handled | Verifizierung war erforderlich, der Käufer hat sie übersprungen, und die Bank hat erneut abgelehnt. |
| approve_with_id | Die Bank konnte die gesendete Zahlung nicht autorisieren; ein weiterer Versuch könnte funktionieren. |
| call_issuer | Die Bank hat ohne Angabe von Gründen abgelehnt und möchte, dass der Karteninhaber sie kontaktiert. |
| card_not_supported | Die Karte kann für diese Art von Einkauf nicht verwendet werden. |
| card_velocity_exceeded | Das Guthaben, Kreditlimit oder Betragslimit der Karte wurde erreicht. |
| currency_not_supported | Die Karte kann nicht in der Währung der Zahlung belastet werden. |
| do_not_honor | Die Bank lehnte die Karte ab, ohne den Grund zu nennen. |
| do_not_try_again | Veralteter Code: aus unbekanntem Grund abgelehnt; belasten Sie diese Karte nicht erneut. |
| duplicate_transaction | Eine identische Zahlung mit derselben Karte wurde vor wenigen Augenblicken eingereicht. |
| expired_card | Die Karte ist abgelaufen. |
| fraudulent | Stripes Betrugsprüfungen vermuteten, dass die Zahlung betrügerisch war, und blockierten sie. |
| generic_decline | Abgelehnt aus unbekanntem Grund, oder blockiert durch Stripe Radar oder Adaptive Acceptance. |
| incorrect_address | Die eingegebene Rechnungsadresse stimmt nicht mit den Aufzeichnungen der Bank überein. |
| incorrect_cvc | Der Sicherheitscode (CVC) der Karte ist falsch. |
| incorrect_number | Die eingegebene Kartennummer ist falsch. |
| incorrect_pin | Die auf einem Kartenleser eingegebene PIN ist falsch. |
| incorrect_zip | Die Rechnungs-Postleitzahl stimmt nicht mit den Aufzeichnungen der Bank überein. |
| insufficient_funds | Die Karte hat nicht genug Geld oder Kredit für diese Zahlung. |
| invalid_account | Die Karte oder das dahinterliegende Konto ist nicht mehr gültig. |
| invalid_amount | Der Zahlungsbetrag ist ungültig oder übersteigt das, was die Karte erlaubt. |
| invalid_cvc | Der Sicherheitscode (CVC) der Karte ist falsch. |
| invalid_expiry_month | Der Ablaufmonat der Karte ist ungültig. |
| invalid_expiry_year | Das Ablaufjahr der Karte ist ungültig. |
| invalid_number | Die Kartennummer ist falsch. |
| invalid_pin | Die eingegebene PIN ist falsch. |
| issuer_not_available | Die Bank der Karte konnte nicht erreicht werden, daher wurde die Zahlung nie autorisiert. |
| lost_card | Die Karte wurde als verloren gemeldet. Sie kann nicht verwendet werden; der Käufer benötigt eine andere Karte. |
| merchant_blacklist | Die Zahlung entsprach einem Eintrag auf der eigenen Stripe-Sperrliste des Shops. |
| new_account_information_available | Die Karte oder das zugehörige Konto ist ungültig; die Bank könnte neuere Details dazu haben. |
| no_action_taken | Die Karte wurde aus einem Grund abgelehnt, den die Bank nicht mitgeteilt hat. |
| not_permitted | Die Bank sagt, dass diese Zahlung mit dieser Karte nicht erlaubt ist. |
| offline_pin_required | Nur persönlich: Die Karte muss eingesteckt und eine PIN eingegeben werden. |
| online_or_offline_pin_required | Nur persönlich: Die Karte benötigt eine PIN, per Online-PIN oder Chip und PIN. |
| pickup_card | Die Karte kann für diese Zahlung nicht verwendet werden; sie wurde möglicherweise als verloren oder gestohlen gemeldet. |
| pin_try_exceeded | Zu viele falsche PIN-Versuche; der Kunde muss eine andere Karte oder Methode verwenden. |
| processing_error | Beim Verarbeiten der Karte ist ein Fehler aufgetreten. Meistens vorübergehend. |
| reenter_transaction | Die Bank konnte die Zahlung aus unbekanntem Grund nicht verarbeiten; versuchen Sie es erneut. |
| restricted_card | Die Karte kann für diese Zahlung nicht verwendet werden; sie wurde möglicherweise als verloren oder gestohlen gemeldet. |
| revocation_of_all_authorizations | Die Bank hat abgelehnt; typischerweise hat der Karteninhaber alle zukünftigen Zahlungen gestoppt. |
| revocation_of_authorization | Die Bank hat abgelehnt; typischerweise hat der Karteninhaber Zahlungen an diesen Shop widerrufen. |
| security_violation | Die Bank hat aus einem nicht mitgeteilten Grund abgelehnt; oft eine Sicherheitsregel. |
| service_not_allowed | Die Karte wurde aus einem Grund abgelehnt, den die Bank nicht angegeben hat. |
| stolen_card | Die Karte wurde als gestohlen gemeldet. Sie kann nicht wieder verwendet werden. |
| stop_payment_order | Die Bank lehnte ab; der Name des Codes weist auf einen Zahlungsstopp für die Karte hin. |
| testmode_decline | Eine Stripe-Testkartennummer wurde bei einer echten Zahlung verwendet. |
| transaction_not_allowed | Die Bank hat abgelehnt; die Karte erlaubt diese Art von Transaktion nicht. |
| try_again_later | Veralteter Code: Die Bank hat aus unbekanntem Grund abgelehnt; versuchen Sie es später erneut. |
| withdrawal_count_limit_exceeded | Der Kunde hat das auf der Karte verfügbare Guthaben oder Kreditlimit überschritten. |
| mobile_device_authentication_required | Die Zahlung benötigt eine Authentifizierung; der Kunde sollte sein Telefon erneut antippen. |
| card_declined | Stripe's Fehlercode für jede abgelehnte Karte; der decline_code sagt, warum. |
| payment_intent_authentication_failure | Die Karte hat die Authentifizierungsprüfung der Bank (wie 3-D Secure) nicht bestanden. |
Welche Stripe Ablehnungscodes können erneut versucht werden
Stripe ordnet viele Ablehnungen als generisch ein, sodass der genaue Grund oft unklar ist. Als Faustregel gilt: Codes für fehlende Deckung, Limitüberschreitung und temporäre Probleme können später behoben werden; falsche Kartendaten erfordern, dass der Käufer sie erneut eingibt; verlorene, gestohlene, gesperrte, eingeschränkte und abgelaufene Karten erfordern eine andere Karte.
Stripe gibt auch einen Ratschlag-Code bei einigen Ablehnungen zurück: `do_not_try_again` bedeutet, die Karte für diese Zahlung nicht erneut zu verwenden, `try_again_later` bedeutet, ein erneuter Versuch ist erlaubt, und `confirm_card_data` bedeutet, dass einige Kartendaten falsch sind. Stripe empfiehlt maximal acht erneute Versuche für eine Zahlung, die Wiederholungen zulässt.
Beim standardmäßigen festen Zeitplan (Wiederholungen im Abstand von 1, 3, 5 und 7 Tagen) stoppen Ablehnungen in den letzten beiden Gruppen auch beim ersten Fehler: Die Karte wird nicht erneut versucht, das Abonnement wird als überfällig gehalten und der Kunde erhält die E-Mail zur Aktualisierung der Karte oder zur Bestätigung der Zahlung. Nur die anderen Gruppen werden nach diesem Zeitplan erneut versucht.
| Gruppe | Beispielcodes | Was passiert |
|---|---|---|
| Geringe Deckung | insufficient_funds | Erneuter Versuch am voraussichtlichen Zahltag des Kunden, oder 2, 5, 8, 13 und 18 Tage nach der ersten Ablehnung: bis zu 6 Versuche (7 bei PayPal, 2 bei einer Prepaid-Karte) |
| Temporär | processing_error, issuer_not_available, try_again_later, card_velocity_exceeded, card_decline_rate_limit_exceeded | Erneuter Versuch 2, 5 und 8 Tage nach der ersten Ablehnung: bis zu 4 Versuche |
| Kein Grund angegeben | do_not_honor, generic_decline, call_issuer, approve_with_id, no_action_taken, duplicate_transaction | Ein erneuter Versuch 48 bis 72 Stunden später, dann wird der Kunde um eine neue Karte gebeten |
| Bankbestätigung erforderlich | authentication_required, authentication_not_handled, mobile_device_authentication_required | Kein blinder erneuter Versuch; der Kunde wird gebeten, die Zahlung bei seiner Bank zu bestätigen |
| Karte kann nicht verwendet werden | lost_card, stolen_card, expired_card, incorrect_number, incorrect_zip, restricted_card, pin_try_exceeded, do_not_try_again | Niemals erneut versucht; der Kunde erhält einen Ein-Klick-Link zur Aktualisierung der Karte |
Was PlatformDTC an der Kasse tut
Der Käufer sieht die Ablehnungsnachricht von Stripe, plus einen einfachen Hinweis für die gängigen Codes, wie z.B. „Ihre Karte hat unzureichende Deckung. Versuchen Sie eine andere Karte.“ und eine Option, sofort eine andere Karte zu versuchen. Für `lost_card`, `stolen_card`, `pickup_card`, `fraudulent` und `merchant_blacklist` ist der Hinweis immer der generische „Ihre Karte wurde abgelehnt. Versuchen Sie eine andere Karte oder kontaktieren Sie Ihre Bank.“, damit dem Käufer niemals mitgeteilt wird, dass eine Karte als verloren oder gestohlen gemeldet oder markiert wurde.
Wenn der Shop PayPal Kartenzahlungen als Backup gewählt hat, kann eine Bankablehnung ohne dauerhaften Grund, wie `do_not_honor` oder `processing_error`, erneut über PayPal versucht werden, wo der Käufer die Karte erneut eingibt. Ablehnungen wegen fehlender Deckung, 3-D Secure, falscher Details, ungültiger Karte und Betrug werden niemals ins Backup verschoben.
Häufige Fragen
- Wo finde ich den Ablehnungscode für eine Stripe Zahlung?
- Im Stripe Dashboard öffnen Sie die fehlgeschlagene Zahlung: Der Ablehnungsgrund wird mit einer kurzen vorgeschlagenen Lösung angezeigt. In der API ist es der `decline_code` im `last_payment_error` des `PaymentIntent`, und das Ergebnis der Zahlung enthält auch den Grund, einen Ratschlag-Code und, wenn das Netzwerk einen gesendet hat, den rohen Netzwerk-Ablehnungscode.
- Was ist der häufigste Stripe Ablehnungscode?
- Stripe sagt, dass Kartenbanken die meisten Ablehnungen als generisch (`generic_decline`) kategorisieren, was den genauen Grund unklar lässt. Wenn die Karteninformationen korrekt sind, rät Stripe, den Kunden zu bitten, seine Kartenbank zu kontaktieren, um den Grund für die Ablehnung der Zahlung zu erfahren.
- Wie oft kann ich einen erneuten Versuch bei einer abgelehnten Stripe Zahlung starten?
- Stripe empfiehlt maximal acht erneute Versuche für Zahlungen, die Wiederholungen zulassen, und warnt, dass zusätzliche Wiederholungen für Kartenbanken wie Betrug aussehen können. Visa erlaubt bis zu 20 Versuche innerhalb von 30 Tagen bei wiederholbaren Ablehnungen und überhaupt keine nach einer Ablehnung der Kategorie 1, wie z.B. einer verlorenen oder gestohlenen Karte.
- Sollte ich dem Käufer den genauen Ablehnungsgrund mitteilen?
- Für die meisten Codes, ja: Ein einfacher Grund wie eine abgelaufene Karte oder ein falscher Sicherheitscode hilft ihnen, das Problem zu beheben. Für `fraudulent`, `lost_card`, `stolen_card` und `merchant_blacklist` sagt Stripe, keine Details anzugeben und die Ablehnung auf die gleiche Weise wie `generic_decline` anzuzeigen.
Quellen
- Stripe Ablehnungscodes — Stripe
- Kartenablehnungen — Stripe
- Fehlercodes — Stripe
- Visa Core Rules und Visa Product and Service Rules (24. Oktober 2026), Tabelle 7-2 — Visa