Testen

Test your integration in a sandbox by simulating transactions with test values—these transactions don’t move funds.

You can access your sandboxes using the account picker in the Dashboard.

Test cards act as “fake” credit cards, and allow you to simulate the following scenarios:

• 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

You can also test non-card payments in a sandbox. Non-card payments are payment methods that aren’t credit or debit cards. Stripe supports various non-card payment options, such as digital wallets and bank transfers. Each payment method has its own special values.

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

When you work with a test card, use test API keys in all API calls. This is true whether you’re serving a payment form to test interactively or writing test code.

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.

Simulate a payment by card brand

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.

Simulate a payment by country

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

Simulate an HSA or FSA card payment

Below are test card numbers for simulating transactions using a health savings account (HSA) and a flexible spending account (FSA). These accounts are commonly used for medical expenses, and testing with them ensures proper handling of healthcare-related transactions within your application.

Simulate a declined payment

To test your integration’s error-handling logic by simulating payments that the issuer declines for various reasons, use test cards from this section. These cards return a card error with the listed error code and decline code.

Provide a CVC when you test CVC behavior. Stripe skips the CVC check if you omit it, so the check can’t fail. To simulate an incorrect CVC, use the “Incorrect CVC decline” test card listed in the following table and provide any three-digit CVC.

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.

To trigger a failed CVC check, include a CVC (any three-digit number). To trigger a failed postal code check, include any valid postal code. If you omit these fields, Radar skips those checks, so they can’t fail.

Trigger an error with invalid data

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: Use a card number that fails the Luhn check, such as 4242424242424241.

Simulate a dispute

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.

Simulate an asynchronous refund

In live mode, refunds are asynchronous: a refund can appear to succeed and later fail, or can appear as pending at first and later succeed. To simulate refunds with those behaviors, use the test cards in this section. With all other test cards, refunds succeed immediately and don’t change status after that.

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.

Send funds to your available balance

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.

Test 3D Secure authentication

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.

Simulate a captcha challenge

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.

Simulate an in-person payment with a PIN

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.

Test a webhook or event destination

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.

Test a non-card payment method

When you use a test non-card payment method, use test API keys in all API calls. This is true whether you’re serving a payment form you can test interactively or writing test code.

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

Test Link

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.

Test a redirect-based flow

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. Go to the payment methods settings in the Dashboard and enable a supported payment method by clicking Turn on in your testing environment.
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.