Umgang mit verschiedenen ModiÖffentliche Vorschau

Erfahren Sie, wie Sie Ihre App für den Live-Modus, den Test-Modus und eine Sandbox-Umgebung anpassen.

Während der Installation können Nutzer/innen auswählen, in welchem Modus Ihre App installiert werden soll.

Der Ort, an dem sich die Option zur Auswahl des Modus während des Installationsablaufs der Stripe-App befindet

Option „Im Testmodus ausprobieren“

Im App-Marktplatz wird potenziellen Nutzern/Nutzerinnen die Option Try in test mode angezeigt, über die sie eine App ausprobieren können.

Die Position des Aktionsaufrufs „Im Testmodus ausprobieren“ im App-Marktplatz

Vorsicht

Wenn Ihre App den OAuth API-Zugriffstyp oder eine externe Installations-URL verwendet, wird die Option Try in test mode im App-Marktplatz nicht angezeigt.

Verknüpfung zur Installation im umgekehrten Modus

Wenn ein/e Nutzer/in den einen Modus installiert hat, können Sie den anderen Modus direkt über das Stripe-Dashboard installieren.

Die Position der Schaltfläche im Stripe-Dashboard, um die App im umgekehrten Modus zu installieren

Webhooks

Wenn Ihre App so eingerichtet ist, dass sie Ereignisse für die Konten Ihrer installierten Nutzer/innen überwacht, muss sie zusätzlich eingerichtet werden, um sicherzustellen, dass Ihre App im Test-Modus (oder in Sandbox-Umgebungen) installiert werden kann.

Wenn ein/e Nutzer/in Ihre App nur im Live-Modus installiert, werden alle entsprechenden Live-Modus-Ereignisse an Ihre Webhook-Endpoints im Live-Modus gesendet. Wenn ein/e Nutzer/in Ihre App nur im Test-Modus installiert, werden alle entsprechenden Test-Modus-Ereignisse an Ihre Test-Modus-Webhook-Endpoints gesendet. Wenn ein/e Nutzer/in Ihre App sowohl im Live-Modus als auch im Test-Modus installiert, werden Test-Modus-Ereignisse an Ihre Test-Modus-Webhook-Endpoints und Live-Modus-Ereignisse nur an Ihre Webhook-Endpoints im Live-Modus gesendet. Wenn ein/e Nutzer/in Ihre App in einer Sandbox-Umgebung installiert, sendet Stripe Ereignisse ausschließlich an die Webhook-Endpoints für die Sandbox.

Notiz

Wir empfehlen, sowohl Live- als auch Test-Webhook-Endpoints einzurichten, um sicherzustellen, dass beide Modi ordnungsgemäß unterstützt werden. Weitere Informationen und Beispiele dazu, wie sich der Installationsmodus auf das Ereignisverhalten auswirkt, finden Sie unter Ereignisverhalten.

OAuth-Test-Modus-Links

OAuth-Apps initiieren die App-Installation von ihrer Plattform aus. Die Entwickler/innen sind für die Implementierung eines Test-Modus verantwortlich, wenn Sie Unterstützung für den Test-Modus wünschen. Das Stripe-Dashboard bietet einen OAuth-Installationslink für den Test-Modus.

Der Speicherort der öffentlichen OAuth-Links im Stripe-Dashboard

Die Stripe Apps OAuth-Dokumentation enthält weitere Informationen zum Erstellen von OAuth-Installationslinks.