Testen

Testen Sie Ihre Integration in einer Sandbox, indem Sie Transaktionen mit Testwerten simulieren – diese Transaktionen bewegen keine Gelder.

Sie können über die Kontoauswahl im Dashboard auf Ihre Sandboxes zugreifen.

Testkarten nehmen die Rolle „gefälschter“ Kreditkarten an und ermöglichen es Ihnen, die folgenden Szenarien zu simulieren:

• Erfolgreiche Zahlungen nach Kartenmarke oder Land
• Kartenfehler aufgrund von Ablehnungen, Betrug oder ungültigen Daten
• Anfechtungen und Rückerstattungen
• Authentifizierung mit 3D Secure und PINs

Sie können auch Zahlungen ohne Karte in einer Sandbox testen. Zahlungen ohne Karte sind Zahlungsmethoden, bei denen es sich nicht um Kredit- oder Debitkarten handelt. Stripe unterstützt verschiedene Zahlungsoptionen ohne Karte, wie beispielsweise Digital Wallets und Banküberweisungen. Jede Zahlungsmethode verfügt über ihre eigenen besonderen Werte.

Verwenden Sie keine Testumgebungen für Belastungstests Ihrer Integration, da Sie möglicherweise an Ratenbegrenzungen stoßen. Informationen zu Belastungstests Ihrer Integration finden Sie unter Belastungstests.

Verwendung von Testkarten

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 in Testumgebungen. Wenn Sie diese verwenden, ist Ihr Code möglicherweise nicht PCI-konform, wenn Sie live gehen. Standardmäßig ist eine PaymentMethod nicht mit einem Kunden verknüpft.

curl https://api.stripe.com/v1/payment_intents \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d amount=500 \
  -d currency=gbp \
  -d payment_method=pm_card_visa \
  -d "payment_method_types[]"=card

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 Ihre Integration immer noch Ihre Test-API-Schlüssel verwendet.

Eine Zahlung mit einer bestimmten Kartenmarke simulieren

Verwenden Sie Testkarten aus der folgenden Liste, um eine erfolgreiche Zahlung für eine bestimmte Kartenmarke zu simulieren.

Grenzüberschreitende Gebühren werden basierend auf dem Land des Kartenausstellers erhoben. Für Karten, deren Ausstellerland nicht die USA ist (z. B. JCB und UnionPay), fallen auch in Testumgebungen Gebühren für grenzüberschreitende Transaktionen an.

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.

Eine Zahlung nach Land simulieren

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

Eine Zahlung mit einer HSA- oder FSA-Karte simulieren

Im Folgenden finden Sie Karten für die Simulation von Transaktionen mit Health Savings Accounts (HSA) und Flexible Spending Accounts (FSA). Diese Konten werden häufig für medizinische Ausgaben verwendet. Durch Tests mit ihnen wird die ordnungsgemäße Abwicklung von Transaktionen im Gesundheitswesen in Ihrer Anwendung sichergestellt.

Abgelehnte Zahlung simulieren

Testen Sie mithilfe von Testkarten aus diesem Bereich die Logik Ihrer Integration für den Umgang mit Fehlern, indem Sie Zahlungen simulieren, die aus verschiedenen Gründen vom Aussteller abgelehnt werden. Diese Karten geben einen Kartenfehler mit dem angegebenen Fehlercode und dem Ablehnungscode zurück.

Geben Sie bei der Überprüfung des CVC-Verhaltens einen CVC an. Stripe überspringt die CVC-Prüfung, wenn Sie diese weglassen, sodass die Prüfung nicht fehlschlagen kann. Um einen falschen CVC zu simulieren, verwenden Sie die in der folgenden Tabelle aufgeführte Testkarte „Ablehnung aufgrund falscher CVC“ und geben Sie einen beliebigen dreistelligen CVC an.

Betrugsprävention

Stripes Betrugspräventionssystem Radar kann Zahlungen blockieren, wenn sie eine hohe Risikostufe aufweisen oder Verifizierungsprüfungen nicht bestehen. Sie können die Karten in diesem Bereich 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.

Um eine fehlgeschlagene CVC-Prüfung auszulösen, geben Sie eine CVC-Nummer (eine beliebige dreistellige Zahl) ein. Um eine fehlgeschlagene Postleitzahlenprüfung auszulösen, geben Sie bitte eine gültige Postleitzahl ein. Wenn Sie diese Felder weglassen, überspringt Radar diese Prüfungen, sodass sie nicht fehlschlagen können.

Einen Fehler mit ungültigen Daten auslösen

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: Einen ungültigen Monat verwenden (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 (z. B. 99).
• incorrect_number: Verwenden Sie eine Kartennummer, bei der die Luhn-Prüfung fehlschlägt, z. B. 4242424242424241.

Eine angefochtene Zahlung simulieren

Um eine angefochtene Zahlung zu simulieren, verwenden Sie die Testkarten in diesem Bereich. Um dann zu simulieren, ob die Anfechtung gewonnen oder verloren wurde, legen Sie Beweise für den Erfolg oder den Misserfolg vor.

Beweis

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

• Wenn Sie mit der API antworten, übergeben Sie den Wert aus der Tabelle als uncategorized_text.
• Wenn Sie im Dashboard oder in In Connect eingebetteten Komponenten antworten, geben Sie den Wert aus der Tabelle in das Feld Zusätzliche Informationen ein. Klicken Sie dann auf Beweise übermitteln.

Eine asynchrone Rückerstattung simulieren

Rückerstattungen erfolgen im Live-Modus asynchron: Eine Rückerstattung kann scheinbar erfolgreich sein und später fehlschlagen, oder sie kann zunächst als ausstehend 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.)

Sie können eine Rückerstattung über eine Karte nur über das Dashboard stornieren. Im Live-Modus können Sie eine Karten-Rückerstattung innerhalb eines kurzen Zeitraums stornieren, der nicht näher spezifiziert ist. In Testumgebungen wird dieser Zeitraum, in dem Sie eine Karten-Rückerstattung stornieren können, mit 30 Minuten simuliert.

Gelder auf Ihr verfügbares Guthaben überweisen

Verwenden Sie die Testkarten in diesem Abschnitt, um Geldmittel 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 testen

3D Secure 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 Bereich testen Ihre 3D Secure-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 ebenfalls 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 Zahlungen 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.

Alle 3DS-Referenzen verweisen auf 3D Secure 2.

Mobile abfragebasierte Abläufe für 3D Secure

Bei einer mobilen Zahlung stehen mehrere abfragebasierte Authentifizierungsabläufe, bei denen die Kundinnen und Kunden mit Eingabeaufforderungen der Nutzeroberfläche interagieren müssen, zur Verfügung. Verwenden Sie die Testkarten in diesem Bereich, 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.

Eine Captcha-Aufgabe simulieren

Um Betrug zu verhindern, zeigt Stripe den Nutzerinnen und Nutzern auf der Bezahlseite möglicherweise eine Captcha-Abfrage an. Anhand der untenstehenden Testkarten können Sie diesen Vorgang simulieren.

Eine Vor-Ort-Zahlung mit PIN simulieren

Verwenden Sie die Testkarten in diesem Bereich, 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-Tests.

Ein Webhook oder Ereignisziel testen

Um Ihren Webhook-Endpoint oder Ihr Ereignisziel zu testen, wählen Sie eine dieser beiden Optionen aus:

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

Ratenbegrenzungen

Wenn Ihre Anfragen in Ihren Testumgebungen beginnen, 429 HTTP-Fehler zu erhalten, führen Sie sie seltener durch. Diese Fehler stammen von unserer Ratenbegrenzung, die in Testumgebungen strenger ist als im Live-Modus.

Wir raten davon ab, für Ihre Integration mit der Stripe-API Belastungstests in Testumgebungen durchzuführen. Da der Lastbegrenzer in Testumgebungen strenger ist, treten möglicherweise Fehler auf, die in der Produktion nicht auftreten würden. Einen alternativen Ansatz finden Sie unter Belastungstests.

Eine andere Zahlungsmethode als mit Karte testen

Wenn Sie eine Zahlungsmethode ohne Karte testen, 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:

Link testen

Derzeit funktioniert Link nur mit Kreditkarten, Debitkarten und qualifizierten Käufen über US-Bankkonten. Link erfordert eine Domain-Registrierung.

Sie können Sandbox-Konten für Link mit jeder gültigen E-Mail-Adresse erstellen. Die folgende Tabelle zeigt die festen einmaligen Passcode-Werte, die Stripe für die Authentifizierung von Sandbox-Konten akzeptiert:

Mehrere Finanzierungsquellen

Da Stripe zusätzliche Unterstützung für Finanzierungsquellen bietet, müssen Sie Ihre Integration nicht aktualisieren. Stripe unterstützt diese automatisch mit der gleichen Transaktionsabwicklungszeit und den gleichen Garantien wie bei Karten- und Bankkontozahlungen.

Einen auf Weiterleitung basierenden Ablauf testen

Um die Weiterleitungslogik Ihrer Integration zu testen, indem Sie eine Zahlung simulieren, die einen Weiterleitungsablauf verwendet (z. B. iDEAL), verwenden Sie eine unterstützte Zahlungsmethode, die Weiterleitungen erfordert.

So erstellen Sie einen Test-PaymentIntent, der entweder erfolgreich durchgeführt wird oder fehlschlägt:

1. Gehen Sie zu den Einstellungen der Zahlungsmethoden im Dashboard und aktivieren Sie eine unterstützte Zahlungsmethode, indem Sie in Ihrer Testumgebung auf Aktivieren klicken.
2. Zahlungsdaten 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.