Test-Modus und Anwendungsszenarien

Verwenden Sie den Test-Modus und unsere Anwendungsszenarien, um Ihre Integration zu testen.

Mit dem Test-Modus von Stripe können Sie Ihre Integration testen, ohne echte Gebühren oder Zahlungen zu tätigen. Der Test-Modus ist eine risikofreie Testumgebung, in der die Erstellung echter Objekte simuliert wird. Dies hat keinen Einfluss auf echte Transaktionen und Geldtransfers. Wir empfehlen, unsere Anwendungsszenarien zur Qualitätssicherung zu verwenden und unsere Postman-Sammlung zu importieren, um den Testvorgang zu verbessern.

Test-Modus

Im Test-Modus können Sie Test-Kreditkarten belasten sowie Test-Produkte und -Preise erstellen. Über den Test-Modus können Sie außerdem Transaktionen simulieren, um sicherzustellen, dass Ihre Integration korrekt funktioniert. So erkennen Sie eventuelle Fehler in Ihrer Stripe-Implementierung, bevor Sie mit tatsächlichen Zahlungen live gehen.

Nachdem Sie ein Stripe-Konto erstellt haben, finden Sie im Stripe-Dashboard mehrere Test-API-Schlüssel. Mit diesen API-Schlüsseln können Sie simulierte Daten erstellen und abrufen, indem Sie Anfragen an die Stripe API stellen. Um mit der Annahme echter Zahlungen zu beginnen, müssen Sie Ihr Konto aktivieren, den Test-Modus ausschalten und die Live-API-Schlüssel in Ihrer Integration verwenden. Stripe bietet eine Reihe von Ressourcen zum Testen Ihrer Integration.

Auswirkungen auf den Live-Modus

Wenn Sie im Dashboard die Einstellungen für den Test-Modus ändern, werden diese auch im Live-Modus geändert. Viele Seiten im Dashboard verfügen über ein weißes Benachrichtigungsfeld und deaktivieren die Live-Modus-Einstellungen im Test-Modus. In diesem Fall können alle noch aktivierten Einstellungen sicher verwendet werden. Wenn keine weiße Beschriftung vorhanden ist, wirken sich alle im Test-Modus vorgenommenen Änderungen auch auf die Einstellungen im Live-Modus aus (außer wenn Sie ein orangefarbenes Testdatenbanner sehen).

Test-Modus im Vergleich zum Live-Modus

Alle Stripe API-Anfragen erfolgen entweder im Test-Modus oder im Live-Modus. API-Objekte sind nicht in beiden Modi gleichzeitig zugänglich. Zum Beispiel kann ein Produktobjekt im Test-Modus nicht Teil einer Zahlung im Live-Modus sein.

Typ	Wann diese eingesetzt werden	Objekte	Verwendung	Überlegungen
Test-Modus	Verwenden Sie den Test-Modus und die damit verbundenen Test-API-Schlüssel, wenn Sie Ihre Integration erstellen. Im Test-Modus verarbeiten die Kartennetzwerke und Zahlungsanbieter keine Zahlungen.	API-Aufrufe geben simulierte Objekte zurück. Sie können zum Beispiel die Testobjekte `account`, `payment`, `customer`, `charge`, `refund`, `transfer`, `balance` und `subscription` abrufen und verwenden.	Verwenden Sie Testkreditkarten und -konten. Darüber können Sie allerdings keine echten Zahlungen akzeptieren oder mit echten Konten arbeiten.	Identity führt keine Verifizierungsprüfungen durch. Connect-Kontenobjekte geben außerdem keine sensiblen Felder zurück.
Live-Modus	Verwenden Sie den Live-Modus und die damit verbundenen Live-API-Schlüssel, wenn Sie bereit sind, Ihre Integration zu starten und echtes Zahlungen anzunehmen. Im Live-Modus werden Zahlungen von Kartennetzwerken und Zahlungsanbietern verarbeitet.	API-Aufrufe geben echte Objekte zurück. Sie können zum Beispiel echte Objekte wie `account`, `payment`, `customer`, `charge`, `refund`, `transfer`, `balance` und `subscription` abrufen und verwenden.	Akzeptieren Sie echte Kreditkarten und arbeiten Sie mit Kundenkonten. Sie können echte Zahlungsautorisierungen, Gebühren und Erfassungen für Kreditkarten und Konten akzeptieren.	Zahlungsanfechtungen haben einen differenzierteren Ablauf und einen einfacheren Testvorgang. Außerdem haben einige Zahlungsmethoden einen differenzierteren Ablauf und es sind mehr Schritte erforderlich.

Die Umschaltfunktion Test-Modus im Dashboard hat keinen Einfluss auf Ihren Integrationscode. Ihre API-Schlüssel für den Test- und den Live-Modus beeinflussen das Verhalten Ihres Codes.

Testkartennummern

Stripe bietet eine Reihe von Testkartennummern, mit denen Sie verschiedene Zahlungsszenarien simulieren können. So können Sie simulierte Zahlungen im Test-Modus erstellen, ohne echte Zahlungen oder Gebühren zu verarbeiten.

Bei der Nutzung von Testkartennummern können Sie ein beliebiges in der Zukunft liegendes Verfallsdatum und einen beliebigen dreistelligen CVC-Code eingeben, um eine erfolgreiche Zahlung zu simulieren. Fehlgeschlagene Zahlungen simulieren Sie, indem Sie bestimmte von Stripe bereitgestellte Testkartennummern und CVC-Codes verwenden.

Testkartennummern sind nur im Test-Modus gültig. Verwenden Sie diese nicht für echte Zahlungen.

Testdaten löschen

Um alle Ihre Testdaten aus Ihrem Stripe-Konto zu löschen, führen Sie die folgenden Schritte aus:

Melden Sie sich im Dashboard an. Dazu können Sie Ihr vorhandenes Stripe-Konto nutzen.
Klicken Sie im Test-Modus auf Entwickler > Übersicht.
Klicken Sie unter Testdaten auf Testdaten prüfen. Im Dialogfeld erhalten Sie eine Liste aller vorhandenen Testdatenobjekte.
Klicken Sie auf Testdaten löschen, um den Löschvorgang einzuleiten. Sie können die Löschung Ihrer Testdaten nicht rückgängig machen.

Der Test-Modus kann vorübergehend nicht genutzt werden, während der Löschvorgang stattfindet.

Notiz

Sie müssen Zähler manuell löschen, da das Objekt vom automatisierten Löschvorgang von Testdaten nicht unterstützt wird.

Test-E-Mail

Standardmäßig sendet Stripe im Testmodus keine E-Mails an Kundinnen/Kunden. Wenn Sie beispielsweise eine Rechnung im Testmodus bezahlen, wird keine E-Mail mit Beleg an den Kunden/die Kundin gesendet. Rechnungen, die über die API im Testmodus abgeschlossen werden, senden auch keine Beleg-E-Mail an den Kunden/die Kundin.

Wenn Sie möchten, dass Stripe Kundinnen/Kunden im Testmodus eine E-Mail sendet, können Sie im Dashboard Folgendes tun:

Erstellen Sie eine Rechnung und verschicken Sie sie manuell an einen bestimmten Kunden/eine bestimmte Kundin.
Senden Sie manuell einen Beleg für eine bezahlte Rechnung.

Wenn Sie E-Mails für Rechnungen und Belege verifizieren möchten, legen Sie die E-Mail-Adresse für Ihr Team im Objekt Customer oder im Attribut receipt_email im PaymentIntent fest.

Anwendungsszenarien testen

Die folgende Tabelle enthält Anwendungsszenarien für Tests zur Qualitätssicherung:

Use Case	Aktion
Zahlung erfolgreich (sofortige Erfassung)	Kein Fehler. Die Abbuchung wird im Dashboard unter Payments als Erfolgreich angezeigt. Stripe erfasst die Abbuchung.
Autorisierung des PaymentIntent erfolgreich (Gelder für später erfassen)	`{ ... "capture_method": "manual", ... "status": "requires_capture", ... }`
Erfassung des PaymentIntent erfolgreich (sofortige Erfassung oder Erfassung von Geldern für später)	`{ ... "status": "succeeded", ... }`
Zahlung fehlgeschlagen	Die Abbuchung wird im Dashboard unter Payments als Fehlgeschlagen angezeigt. `{ "error": { "charge": "ch_GI0sHNu7AE782zUi", "code": "card_declined", "decline_code": "<<REASON HERE>>", "doc_url": "https://docs.stripe.com/error-codes#card-declined", "message": "Your card was declined.", "type": "card_error" } }`
Radar-Blockierung	Unabhängig davon, welche Version von Radar Sie verwenden, kann eine Zahlung aufgrund eines hohen Risikos oder aufgrund einer Regel blockiert werden. Die Antwort ist die Gleiche wie die, die Sie erhalten, wenn eine Abbuchung fehlschlägt.
Zahlung angefochten	Die Abbuchung wird im Dashboard unter Payments als Angefochten angezeigt. Stripe zieht den Zahlungsbetrag zuzüglich der Anfechtungsgebühr vom Saldo ab und erstellt ein `Dispute`-Objekt zusammen mit dem zugehörigen `charge.dispute.created`-Ereignis. `{ "object": { "id": "du_in6gyYHec0deHCQc", "object": "dispute", "charge_id": "ch_mKySwYMiUlbou1oP", ... "status": "needs_response" } }`
Zahlungsanfrage eröffnet	Anfragen ähneln Zahlungsanfechtungen, es gibt jedoch drei wichtige Unterschiede: Gelder werden erst eingezogen, wenn wir eine Anfrage zu einer Zahlungsanfechtung eskalieren, sie bleiben rückerstattbar, bis sie angefochten werden, und sie weisen andere Status auf. In diesem Fall löst Stripe ein `charge.dispute.created` aus: `{ "object": { "id": "du_z3n8XC70kGMyjNNS", "object": "dispute", "charge_id": "ch_fKVMpDwntu0RI582", ... "is_charge_refundable": true, ... "status": "warning_needs_response" } }`
Anfechtung zu Ihren Gunsten entschieden	Wenn eine Zahlungsanfechtung zugunsten einer Kundin/eines Kunden entschieden wird, werden die Gelder der ursprünglichen Zahlung abzüglich der Anfechtungsgebühr ihrem/seinem Konto gutgeschrieben. Stripe aktualisiert das vorhandene `Dispute`-Objekt und löst ein `charge.dispute.closed`-Ereignis aus. `{ "object": { "id": "du_2I0fD8FqOmEgKcim", "object": "dispute", "charge_id": "ch_nW0Jc6SuonlZy3ER", ... "status": "won" } }`
Anfechtung verloren	Wenn eine Zahlungsanfechtung nicht zugunsten einer Kundin/eines Kunden entschieden wird, aktualisiert Stripe das vorhandene `Dispute`-Objekt und löst ein `charge.dispute.closed`-Ereignis aus. `{ "object": { "id": "du_PlB6D9IRvU7Zcbmv", "object": "dispute", "charge_id": "ch_y8ehxfcRbbjRQxTq", ... "status": "lost" } }`
Anfrage gewonnen	Wenn eine Anfrage zu Ihren Gunsten entschieden wird, bleibt Ihr Guthaben dasselbe, da keine Gelder abgezogen wurden, als Sie die Anfrage eröffnet haben. Stripe aktualisiert das vorhandene `Dispute` -Objekt und löst ein `charge.dispute.closed`-Ereignis aus. `{ "object": { "id": "du_P3WbpjyvZdbk251J", "object": "dispute", "charge_id": "ch_irkzvPpaRr5gljJu", ... "status": "warning_closed" } }`
Anfrage verloren	Wenn Sie eine Anfrage verlieren, wird diese zu einer Zahlungsanfechtung eskaliert. Wenn die Anfrage in eine Zahlungsanfechtung eskaliert wird, ändert sich sein Status mit einem `charge.dispute.updated`-Ereignis, und Gelder werden mit einem `charge.dispute.funds_withdrawn`-Ereignis eingezogen: `{ "object": { "id": "du_2DhLIGiRbc45Akz2", "object": "dispute", "charge_id": "ch_XcbXuG9fFn4rssWw", ... "status": "needs_response" } }`
Zahlung zurückerstattet	Die Abbuchung wird im Dashboard unter Payments als Rückerstattet angezeigt. `{ "id": "re_TmVqltQ4aHxuU3tE", "object": "refund", "amount": "<<FULL AMOUNT>>", "charge": "ch_lt4AvC2nvg3nTb6W", ... "payment_intent": "pi_SVoYTsuKT6JIgGIE", // if you're using PaymentIntents ... "status": "succeeded" }`
Abbuchung teilweise zurückerstattet	Die Abbuchung wird im Dashboard unter Payments als Rückerstattet angezeigt. Der zurückerstattete Betrag weicht vom Zahlungsbetrag ab. Sie können auch teilweise erstattete Zahlungen weiterhin anfechten. `{ "id": "re_MEdGL3DohyGGLIBN", "object": "refund", "amount": "<<PARTIAL AMOUNT>>", "charge": "ch_LiTzvp1czt0UpaE3", ... "payment_intent": "pi_ItI6OD1CiqK2fiHu", // if you are using PaymentIntents ... "status": "succeeded" }`
Kontoguthaben rutscht ins Minus	Stellen Sie sicher, dass Ihr Stripe-Konto keinen negativen Saldo aufweist und überprüfen Sie, ob Ihre Bankkonten Abbuchungen von uns annehmen können.
Auszahlung erfolgreich	Wenn Sie Webhooks für eine erfolgreiche Auszahlung aktivieren (empfohlen), testen Sie, wie Sie das Ereignis handhaben.
Auszahlung fehlgeschlagen	Wenn Sie Webhooks für eine fehlgeschlagene Auszahlung aktivieren (empfohlen), testen Sie, wie Sie das Ereignis handhaben.

Die Postman-Sammlung von Stripe

Postman ist ein viel genutztes API-Entwicklungstool. Um die Integration von Stripe zu vereinfachen, bieten wir eine auf Payments abgestimmte Postman-Sammlung zusammen mit den Tools an, die Sie zum Testen der serverseitigen Komponente Ihrer Integration benötigen.

Sammlung importieren

Um zu beginnen, müssen Sie die Postman-App öffnen. Hierfür können Sie die Browser- oder die Desktop-Version verwenden. Starten Sie die App und importieren Sie dann die Sammlung.

Um diesen Vorgang im Web zu starten, klicken Sie oben links auf die Schaltfläche Importieren und dann auf die Option Link. Fügen Sie den Link für die Payments-Sammlung ein. Wenn Sie die Desktop-App von Postman nutzen, klicken Sie auf Datei > Importieren. Nach einem erfolgreichen Import wird die Sammlung unter Sammlungen angezeigt.

Das Import-Dialogfeld

Die Sammlung verwenden

Um die Sammlung zu verwenden, navigieren Sie zu der Sammlung, die Sie soeben importiert haben, und klicken Sie auf Variablen. Kopieren Sie Ihren Stripe-Geheimschlüssel aus dem Stripe-Dashboard und fügen Sie ihn in das Feld Ursprünglicher Wert ein. Nach Abschluss dieses Schritts können Sie damit beginnen, Anfragen zu stellen.

Andere Variablen werden während der Laufzeit der Erfassung durch Skripte ausgefüllt. Wenn Sie beispielsweise eine/einen Kundin/Kunden, einen Preis, eine Abbuchung oder einen PaymentIntent erstellen, speichert das System diese ID über ein Skript in der Erfassung. Die ID kann dann bei künftigen Anfragen, wie z. B. die Ausstellung einer Rückerstattung, genutzt werden.

Die Registerkarte „Variablen“ für die Sammlung

Einer Postman-Sammlung einen Geheimschlüssel hinzufügen