Anwendungsszenarien für Tests

Erfahren Sie, wie Sie Ihre Integration testen können.

Mit den Testumgebungen von Stripe, wie dem Test-Modus und den Sandboxes, können Sie Ihre Integration testen, ohne echte Abbuchungen oder Zahlungen zu tätigen. Diese Umgebungen simulieren die Erstellung realer Objekte, ohne die tatsächlichen Transaktionen zu beeinflussen oder echtes Geld zu bewegen. Wir empfehlen, unsere Anwendungsszenarien zur Qualitätssicherung zu verwenden und unsere Postman-Sammlung zu importieren, um den Testvorgang zu verbessern.

Testumgebungen

In einer Testumgebung können Sie Testkreditkarten belasten sowie Testprodukte und Preise erstellen. In diesen Umgebungen können Sie Transaktionen simulieren, um sicherzustellen, dass Ihre Integration korrekt funktioniert. Mit dieser Funktion erkennen Sie potenzielle Fehler in Ihrer Stripe-Implementierung, bevor Sie mit tatsächlichen Zahlungen live gehen. Erfahren Sie, wie Sie sich zwischen der Verwendung des Test-Modus und Sandboxes entscheiden.

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 echten API-Schlüssel in Ihrer Integration verwenden. Stripe stellt umfangreiche Prüfmaterialien rund um die Integration zur Verfügung.

Auswirkungen auf den Live-Modus bei Verwendung des Test-Modus

Wenn Sie Einstellungen im Dashboard im Test-Modus ändern, können Sie diese auch im Live-Modus ändern. 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).

Testumgebungen vergleichen

Der Test-Modus und Sandboxes sind Testumgebungen, die die Erstellung echter Objekte simulieren, ohne das Risiko, echte Transaktionen zu beeinflussen oder echtes Geld zu bewegen. Wenn Sie wissen, wann Sie sie verwenden sollten, können Sie Ihre Teststrategie entwickeln.

Wir empfehlen die Verwendung von Sandboxes für Ihre Testanforderungen, da sie im Vergleich zum Test-Modus zusätzliche Funktionen und eine größere Flexibilität bieten. Durch die Umstellung auf Sandboxes können Sie Ihre Testfunktionen mit mehreren Umgebungen, granularer Zugriffskontrolle und isolierten Einstellungen erweitern, sodass Sie eine robustere und umfassendere Teststrategie entwickeln können.

Unterschiede in der Funktionalität zwischen dem Test-Modus und Sandboxes

Sehen Sie sich die folgende Tabelle an, um die Unterschiede zu verstehen und die am besten geeignete Umgebung für Ihre Anforderungen auszuwählen.

	Test-Modus	Sandboxes
Anzahl der Umgebungen	Eine Umgebung verwenden	Bis zu fünf Umgebungen verwenden
Zugriffskontrolle	Gewähren Sie allen Nutzer/innen mit Rollen die gleichen Rollen und den gleichen Zugriff.	Kontrollieren Sie den Zugriff genau. Nur Admins haben automatisch Zugriff. Laden Sie Nutzer/innen nur zu Sandboxes ein, ohne Zugriff auf den Live-Modus.
Einstellungen	Teilen Sie Einstellungen zwischen dem Live-Modus und dem Test-Modus. Viele Einstellungen können nicht unabhängig voneinander getestet werden.	Isolieren Sie die Einstellungen für jede Sandbox vollständig. Kopieren Sie bei der Erstellung Einstellungen aus dem Live-Modus und testen Sie sie unabhängig von Ihrer Live-Integration.
Produkteinschränkungen	Sie können die IC+-Preise im Test-Modus nicht testen.	Sie können die IC+-Preise nicht in einer Sandbox testen.
Unterstützte Versionen	Unterstützt nur V1	Unterstützt V1 und V2 (einschließlich Produkten wie nutzungsbasierte Abrechnung und Ereignisziele).
Ratenbegrenzungen	Behalten Sie konsistente Ratenbegrenzungen bei.	Behalten Sie konsistente Ratenbegrenzungen bei.
Kartennummern für Testzwecke	Verwenden Sie die gleichen Testkartennummern.	Verwenden Sie die gleichen Testkartennummern.

Vom Test-Modus zu Sandboxes wechseln

So wechseln Sie im Dashboard vom Test-Modus zu Sandboxes:

Erstellen Sie eine Sandbox und laden Sie die Nutzer/innen ein, die Zugriff darauf benötigen.
- Wenn Sie einem Teammitglied die Sandbox-Nutzerrolle zuweisen, gewähren Sie ihm/ihr damit Zugriff zum Erstellen von Sandboxes, die mit Ihrem Live-Geschäftskonto verknüpft sind, und Zugriff zum Löschen von Sandboxes, die er/sie erstellt hat. Im Gegensatz zum Test-Modus, in dem alle Nutzer/innen automatischen Zugriff hatten, können nur diejenigen mit der Sandbox-Benutzerrolle, der Administratorrolle, der Entwicklerrolle oder der Rolle „Sandbox-Administrator/in“ auf Sandboxes zugreifen.
Beziehen Sie neue Test-API-Schlüssel und Ihre Konto-ID für Ihre Sandbox.
Richten Sie relevante Testdaten wie Testprodukte, Kundinnen/Kunden, Abonnements und Zahlungsmethoden ein.
- (Optional) Richten Sie Test-Uhren ein, mit deren Hilfe Sie Ihre Billing-Integration testen und sicherstellen können, dass sich diese so verhält wie erwartet. Beim Verwenden von Test-Uhren simulieren Sie den zeitlichen Ablauf in der Sandbox, wodurch sich der Status von Billing-Ressourcen wie Abonnements ändert und Webhook-Ereignisse ausgelöst werden. Auf diese Weise können Sie sehen, wie Ihre Integration mit Szenarien wie einer fehlgeschlagenen Zahlung für eine vierteljährliche oder jährliche Verlängerung umgeht, ohne längere Zeit warten zu müssen.
Aktualisieren Sie jeden Teil Ihrer Testprozesse, der von bestimmten Testobjekt-IDs abhängt. Dies ändert sich, wenn Sie neue Objekte in einer Sandbox erstellen.

Testumgebungen im Vergleich zum Live-Modus

Alle Anfragen der Stripe API erfolgen entweder in Testumgebungen oder im Live-Modus. API-Objekte in einem Modus sind für den anderen nicht zugänglich. Beispielsweise kann ein Test-Produktobjekt nicht Teil einer Zahlung im Live-Modus sein.

Typ	Wann diese eingesetzt werden	Objekte	Verwendung	Überlegungen
sandboxes	Use a sandbox, and its associated test API keys, as you build your integration. In a sandbox, card networks and payment providers don’t process payments.	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 Verwendung in einer Testumgebung im Dashboard hat keinen Einfluss auf Ihren Integrationscode. Ihre API im Test- und im Live-Modus beeinflussen das Verhalten Ihres Codes. Ihre API im Test- und im 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 in Testumgebungen 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 in Testumgebungen gültig. Verwenden Sie sie 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 in Ihren Testumgebungen auf Entwickler/innen > Ü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.

Testumgebungen können während des Löschvorgangs vorübergehend nicht verwendet werden.

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 Kundinnen/Kunden in Testumgebungen keine E-Mails. Beispielsweise wird beim Bezahlen einer Rechnung in einer Sandbox keine Beleg-E-Mail an den Kunden/die Kundin gesendet. Auch Rechnungen, die in Testumgebungen über die API finalisiert werden, senden keine Beleg-E-Mail an die Kundinnen/Kunden.

Wenn Sie möchten, dass Stripe Kundinnen/Kunden in der Testumgebung 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_4wgpUwEb9hBuL11Z", "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_gOiIiqywoBgQXkLw", "object": "dispute", "charge_id": "ch_WiqDFk2xhSiqg3UW", ... "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_tpvEIUsG8aufgWi6", "object": "dispute", "charge_id": "ch_ynAvlrebshpy3Oqu", ... "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_O4I57D5Nl2yA0hPu", "object": "dispute", "charge_id": "ch_W80rRnFejV72qI8g", ... "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_pyevPigk7yXjbnjg", "object": "dispute", "charge_id": "ch_HoAkGIh7EFaXJvTV", ... "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_SxUnaVSqKNAqA34O", "object": "dispute", "charge_id": "ch_vs6vYJDNjGi3HIze", ... "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_nk8wmfOzqmjnBbV2", "object": "dispute", "charge_id": "ch_DGwXT8t63qM7wUSI", ... "status": "needs_response" } }`
Zahlung zurückerstattet	Die Abbuchung wird im Dashboard unter Payments als Rückerstattet angezeigt. `{ "id": "re_HuP7HNs1Uh5ZqbvB", "object": "refund", "amount": "<<FULL AMOUNT>>", "charge": "ch_PyLUqgaHFAHxATps", ... "payment_intent": "pi_N0CzPfJhphbRHEDD", // 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_zWn6jfaCOhMmjTIO", "object": "refund", "amount": "<<PARTIAL AMOUNT>>", "charge": "ch_M4DpX57DnTPLj19X", ... "payment_intent": "pi_iA1Tqk30dHrguwXw", // 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