Wenn Sie auf den Stripe-Fehler "Zahlungsversuch fehlgeschlagen, da eine zusätzliche Aktion erforderlich ist" stoßen, erklärt dieser Leitfaden die Ursache und wie Sie das Problem lösen.

Was diesen Fehler verursacht

Dieser Fehler tritt typischerweise aufgrund der Anforderungen der Starken Kundenauthentifizierung (SCA) unter den europäischen PSD2-Vorschriften auf. SCA verlangt eine Zwei-Faktor-Authentifizierung für viele Online-Zahlungen, was bedeutet, dass Kunden ihre Identität bei ihrer Bank verifizieren müssen, bevor die Zahlung abgeschlossen wird.

Wenn eine Zahlung SCA erfordert, Ihre Integration den Authentifizierungsablauf aber nicht handhabt, gibt Stripe diesen Fehler zurück.

So beheben Sie es

Für Kunden

Prüfen Sie Ihre Bank-App oder E-Mail. Ihre Bank hat möglicherweise eine Authentifizierungsanfrage gesendet, die genehmigt werden muss.
Versuchen Sie die Zahlung erneut. Einige Banken verlangen, dass Sie die Transaktion über ihre mobile App oder Website ausdrücklich genehmigen.
Kontaktieren Sie Ihre Bank. Wenn das Problem bestehen bleibt, blockiert Ihre Bank möglicherweise die Transaktion und kann bei der Autorisierung helfen.
Verwenden Sie eine andere Zahlungsmethode. Wenn Ihre primäre Karte weiterhin fehlschlägt, probieren Sie eine alternative Karte oder Zahlungsmethode.

Für Entwickler

Implementieren Sie Stripes Payment Intents API. Die ältere Charges API unterstützt kein SCA. Payment Intents handhaben den Authentifizierungsablauf automatisch.
Verwenden Sie Stripe.js und Stripe Elements. Diese clientseitigen Tools verwalten das 3D-Secure-Authentifizierungs-Popup, das Banken verlangen.
Handhaben Sie den Status requires_action. Wenn ein PaymentIntent diesen Status zurückgibt, verwenden Sie stripe.confirmCardPayment() auf der Client-Seite, um den Authentifizierungsablauf der Bank auszulösen.
Aktualisieren Sie die Webhook-Handler. Stellen Sie sicher, dass Ihr Backend das payment_intent.succeeded-Event verarbeitet, das nach erfolgreicher Authentifizierung ausgelöst wird, und nicht nur das initiale Erstellungs-Event.

Beispiel-Ablauf

1. Kunde reicht Zahlung ein
2. Stripe gibt PaymentIntent mit Status: requires_action zurück
3. Ihr Frontend ruft stripe.confirmCardPayment(clientSecret) auf
4. Kunde schließt Bank-Authentifizierung ab (3D-Secure-Popup)
5. Stripe bestätigt Zahlung und löst Webhook aus
6. Ihr Backend verarbeitet die erfolgreiche Zahlung

Zukünftige Probleme vermeiden

Verwenden Sie für neue Integrationen immer die Payment Intents API
Testen Sie mit Stripes SCA-Testkartennummern (z.B. 4000 0027 6000 3184 für erforderliche Authentifizierung)
Implementieren Sie eine ordnungsgemäße Fehlerbehandlung für alle Zahlungsstatus
Halten Sie Ihre Stripe-Bibliotheksversionen aktuell

Die SCA-Anforderung betrifft alle Unternehmen, die Zahlungen von europäischen Kunden verarbeiten. Die ordnungsgemäße Implementierung der Zahlungsauthentifizierung ist nicht optional -- sie ist eine regulatorische Anforderung.