Test payment methods (2024)

Um zu bestätigen, dass Ihre Integration korrekt funktioniert, können Sie Transaktionen simulieren, ohne Geld zu bewegen. Verwenden Sie dazu spezielle Werte im Testmodus.

Mit Testkarten können Sie verschiedene Szenarien simulieren:

• Erfolgreiche Zahlungen nach Marke der Kart oder Land
• Kartenfehler aufgrund von abgelehnten Zahlungen, Betrug oder ungültigen Daten
• Zahlungsanfechtungen und Rückerstattungen
• Authentifizierung mit 3D Secure und PINs

Das Testen von Zahlungen ohne Karte funktioniert auf ähnliche Weise. Jede Zahlungsmethode verfügt über eigene spezielle Werte. Aufgrund von Ratenbegrenzungen raten wir davon ab, den Test-Modus für Belastungstests Ihrer Integration zu verwenden. Sehen Sie sich stattdessen unsere Dokumentation zu Belastungstests an.

Verwendung von Testkarten

Jedes Mal, wenn Sie mit einer Testkarte arbeiten, verwenden Sie in allen API-Aufrufen Test-API-Schlüssel. Dies gilt unabhängig davon, ob Sie ein Zahlungsformular bereitstellen, um interaktive Tests durchzuführen, oder ob Sie Testcode schreiben.

Interaktives Testen

Verwenden Sie beim interaktiven Testen eine Kartennummer, z. B. 4242 4242 4242 4242. Geben Sie die Kartennummer im Dashboard oder in einem beliebigen Zahlungsformular ein.

• Verwenden Sie ein gültiges Datum in der Zukunft, wie 12/34.
• Verwenden Sie eine beliebige dreistellige Prüfziffer/CVC (vier Ziffern für American Express-Karten).
• Verwenden Sie für andere Formularfelder einen beliebigen Wert.

Testcode verwenden

Verwenden Sie beim Schreiben von Testcode eine PaymentMethod wie pm_card_visa anstelle einer Kartennummer. Wir raten davon ab, Kartennummern direkt in API-Aufrufen oder serverseitigem Code zu verwenden, auch nicht im Test-Modus. Wenn Sie diese verwenden, ist Ihr Code möglicherweise nicht PCI-konform, wenn Sie live gehen. Standardmäßig ist eine PaymentMethod nicht an eine/n Kunden/Kundin. angehängt.

curl https://api.stripe.com/v1/payment_intents \ -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \ -d amount=500 \ -d currency=gbp \ -d payment_method=pm_card_visa

Die meisten Integrationen verwenden keine Token mehr, aber wir stellen Test-Token wie tok_visa zur Verfügung, wenn Sie diese benötigen.

Wenn Sie bereit sind, Ihre Integration live zu schalten, ersetzen Sie Ihre für den Test zu veröffentlichenden und geheimen API-Schlüssel durch Live-Schlüssel. Sie können keine Live-Zahlungen verarbeiten, wenn von Ihrer Integration immer noch Ihre Test-API-Schlüssel verwendet werden.

Karten nach Marke

Verwenden Sie Testkarten aus der folgenden Liste, um eine erfolgreiche Zahlung zu simulieren. Als Abrechnungsland für jede Testkarte werden die Vereinigten Staaten festgelegt. Wenn Sie Testkartenzahlungen mit Karten für andere Abrechnungsländer erstellen müssen, nutzen Sie unsere internationalen Testkartennummern.

Die meisten Cartes Bancaires- und EFTPOS-Karten haben ein Co-Branding mit Visa oder Mastercard. Die Testkarten in der folgenden Tabelle simulieren erfolgreiche Zahlungen mit Co-Branding-Karten.

Karten nach Land

Um erfolgreiche Zahlungen aus bestimmten Ländern zu simulieren, verwenden Sie Testkarten aus den folgenden Abschnitten.

Abgelehnte Zahlungen

Testen Sie mithilfe von Testkarten aus diesem Abschnitt die Logik für den Umgang mit Fehlern Ihrer Integration, indem Sie Zahlungen simulieren, die aus verschiedenen Gründen vom Aussteller abgelehnt werden. Die Verwendung einer dieser Karten führt zu einem Kartenfehler mit dem angegebenen Fehlercode und Ablehnungscode.

Betrugsprävention

Das Betrugspräventionssystem von Stripe, Radar, kann Zahlungen blockieren, wenn sie ein hohes Risikolevel aufweisen oder Verifizierungsprüfungen nicht bestehen. Sie können die Karten in diesem Abschnitt verwenden, um Ihre Radar-Einstellungen zu testen. Außerdem können sie verwendet werden, um zu testen, wie Ihre Integration auf blockierte Zahlungen reagiert.

Jede Karte simuliert bestimmte Risikofaktoren. Ihre Radar-Einstellungen bestimmen darüber, welche Risikofaktoren dazu führen, dass eine Zahlung blockiert wird. Blockierte Zahlungen führen zu Kartenfehlern mit einem Betrugs-Fehlercode.

Ungültigen Daten

Geben Sie ungültige Details an, um Fehler aufgrund ungültiger Daten zu testen. Dafür benötigen Sie keine spezielle Testkarte. Jeder ungültige Wert funktioniert. Beispiel:

• invalid_expiry_month: Verwenden Sie einen ungültigen Monat, z. B. 13.
• invalid_expiry_year: Verwenden Sie ein Jahr, das bis zu 50 Jahre in der Vergangenheit liegt, z. B. 95
• invalid_cvc: Verwenden Sie eine zweistellige Zahl, wie 99.
• incorrect_number: Verwenden Sie eine Kartennummer, die die Luhn-Prüfung nicht besteht, z.B.

Angefochtene Zahlungen

Verwenden Sie die Testkarten in diesem Abschnitt, um eine angefochtene Transaktion zu simulieren. Stellen Sie dann Beweise für eine verlorene oder gewonnene Anfechtung bereit, um das jeweilige Szenario zu simulieren.

Nachweis

Um eine gewonnene oder verlorene Zahlungsanfechtung zu simulieren, antworten Sie mit einem der Beweiswerte aus der nachfolgenden Tabelle.

• Wenn Sie über die API antworten, übergeben Sie den Wert aus der Tabelle als uncategorized_text.
• Wenn Sie im Dashboard antworten, geben Sie den Wert aus der Tabelle in das Feld Zusätzliche Informationen ein. Klicken Sie dann auf Beweise einreichen.

Rückerstattungen

Rückerstattungen erfolgen im Live-Modus asynchron: Eine Rückerstattung kann scheinbar erfolgreich sein und später fehlschlagen, oder sie kann zunächst als pending erscheinen und später erfolgreich sein. Verwenden Sie die Testkarten in diesem Abschnitt, um Rückerstattungen mit diesen Verhaltensweisen zu simulieren. (Bei allen anderen Testkarten sind Rückerstattungen sofort erfolgreich und der Status bleibt unverändert.)

Verfügbarer Saldo

Verwenden Sie die Testkarten in diesem Abschnitt, um Gelder aus einer Testtransaktion direkt auf Ihr verfügbares Guthaben zu überweisen. Andere Testkarten senden Geld von einer erfolgreichen Zahlung an Ihr ausstehendes Guthaben.

3D Secure-Authentifizierung

3DSecure erfordert einen zusätzlichen Authentifizierungsschritt für Kreditkartentransaktionen. Mit den Testkarten in diesem Abschnitt können Sie simulieren, wie die Authentifizierung in verschiedenen Zahlungsabläufen ausgelöst wird.

Nur Karten in diesem Abschnitt testen Ihre 3DSecure-Integration effektiv, da sie definiertes 3DS-Verhalten simulieren, wie z.B. einen abfragebasierten Ablauf oder eine nicht unterstützte Karte. Andere Testkarten von Stripe lösen möglicherweise weiterhin 3DS aus, wir geben jedoch dann attempt_acknowledged zurück und umgehen so die zusätzlichen Schritte, da 3DS-Tests bei diesen Karten nicht von Wichtigkeit sind.

Authentifizierung und Einrichtung

Verwenden Sie die Testkarten in diesem Abschnitt, um Zahlungsströme mit Authentifizierung zu simulieren. Einige dieser Karten können auch für zukünftige Zahlungen eingerichtet werden oder wurden bereits entsprechend eingerichtet.

Support und Verfügbarkeit

Stripe fordert eine Authentifizierung an, wenn dies gesetzlich vorgeschrieben ist oder durch Ihre Radar-Regeln oder benutzerdefinierten Code ausgelöst wird. Auch wenn eine Authentifizierung angefordert wird, kann diese nicht immer durchgeführt werden– beispielsweise ist die Kundenkarte möglicherweise nicht registriert oder es tritt ein Fehler auf. Verwenden Sie die Testkarten in diesem Abschnitt, um diese Faktoren in verschiedenen Kombinationen zu simulieren.

Mobile abfragebasierte Abläufe für 3D Secure

Bei einer mobilen Zahlung stehen mehrere abfragebasierte Abläufe, bei denen die Kund/innen mit Eingabeaufforderungen der Benutzeroberfläche interagieren müssen, zur Verfügung. Verwenden Sie die Testkarten in diesem Abschnitt, um einen bestimmten abfragebasierten Ablauf zu Testzwecken auszulösen. Diese Karten sind in browserbasierten Zahlungsformularen oder in API-Aufrufen unbrauchbar. In diesen Umgebungen funktionieren sie, lösen aber kein besonderes Verhalten aus. Da sie in API-Aufrufen nicht nützlich sind, stellen wir keine PaymentMethod oder Token-Werte für Tests zur Verfügung.

Zahlungen mit PINs

Verwenden Sie die Testkarten in diesem Abschnitt, um erfolgreiche persönliche Zahlungen zu simulieren, bei denen eine PIN erforderlich ist. Es gibt viele andere Optionen zum Testen persönlicher Zahlungen, einschließlich eines simulierten Lesegeräts und physischer Testkarten. Weitere Informationen finden Sie unter Stripe Terminal testen.

Webhooks

Sie haben zwei Optionen, um Webhooks zu testen:

1. Führen Sie Aktionen im Testmodus durch, die zulässige Ereignisse an Ihren Endpoint senden. Um beispielsweise das Ereignis charge.succeeded auszulösen, können Sie eine Testkarte, die eine erfolgreiche Abbuchung erzeugt verwenden.
2. Ereignisse mit der Stripe-CLI oder mit Stripe für Visual Studio Code auslösen.

Ratenbegrenzungen

Wenn Ihre Anfragen im Testmodus HTTP-Fehler vom Typ 429 erhalten, sollten Sie diese weniger häufig durchführen. Diese Fehler stammen von unserem Ratenbegrenzer, der im Testmodus strenger ist als im Live-Modus.

Wir raten davon ab, Ihre Integration mit der Stripe-API im Testmodus zu testen. Da der Lastbegrenzer im Testmodus strenger ist, treten möglicherweise Fehler auf, die Sie in der Produktion nicht sehen würden. Einen alternativen Ansatz finden Sie unter Lasttests.

Zahlungen ohne Karte

Jedes Mal, wenn Sie eine Testzahlungsmethode ohne Karte nutzen, verwenden Sie in allen API-Aufrufen Test-API-Schlüssel. Dies gilt unabhängig davon, ob Sie ein Zahlungsformular bereitstellen, das Sie interaktiv testen können, oder ob Sie Testcode schreiben.

Für verschiedene Zahlungsmethoden werden unterschiedliche Testvorgänge durchgeführt:

Wird umgeleitet

Um die Logik für den Umgang mit Umleitungen Ihrer Integration zu testen, indem Sie eine Zahlung simulieren, die einen Umleitungsablauf verwendet (zum Beispiel iDEAL), verwenden Sie eine unterstützte Zahlungsmethode, die Weiterleitungen erfordert.

So erstellen Sie einen PaymentIntent, der entweder erfolgreich ist oder fehlschlägt:

1. Navigieren Sie zu den Einstellungen für Zahlungsmethoden im Dashboard und aktivieren Sie eine unterstützte Zahlungsmethode, indem Sie auf Im Test-Modus aktivieren klicken.
2. Zahlungsdetails erfassen.
3. Zahlung an Stripe senden.
4. Autorisieren Sie die Testzahlung oder lassen Sie sie fehlschlagen.

Stellen Sie sicher, dass die Seite (entsprechend return_url) auf Ihrer Website den Status der Zahlung angibt.