# Sandbox-Unterstützung für Ihre öffentliche App aktivieren Aktivieren Sie Ihre öffentliche App für die Sandbox-Installation. [Sandboxes](https://docs.stripe.com/sandboxes.md) sind die Testumgebung von Stripe. Ihre Nutzer/innen können Apps in Sandboxes installieren, um die Funktionen und die Funktionalität der Apps zu testen. ## Unterstützung für die allgemeine Sandbox im Vergleich zur Sandbox im Test-Modus Stripe unterstützt zwei Umgebungen: den Live-Modus und Sandboxes. Jedes Stripe-Konto verfügt über Sandboxes, darunter auch eine Sandbox im Test-Modus. Die Sandbox im Test-Modus ist eine besondere Art von Sandbox, deren Eigenschaften sich [von denen allgemeiner Sandboxes unterscheiden](https://docs.stripe.com/testing-use-cases.md#compare). Daher muss Ihre App sowohl allgemeine Sandboxes als auch Sandboxes im Test-Modus ausdrücklich unterstützen. Sie können beide Arten von Sandboxes unterstützen, damit mehr Unternehmen Ihre App testen können, bevor sie live geht. ### Allgemeine Sandbox-Unterstützung für Ihre App aktivieren Standardmäßig können Nutzer/innen Ihre öffentliche App nicht ohne zusätzlichen Aufwand in einer Sandbox installieren. Sie können Sandbox-Installationen aktivieren, indem Sie das [App-Manifest](https://docs.stripe.com/stripe-apps/reference/app-manifest.md) aktualisieren. Nachdem Sie die Sandbox-Unterstützung aktiviert haben, [reichen Sie Ihre App zur Prüfung](https://docs.stripe.com/stripe-apps/publish-app.md) ein. Die Sandbox-Unterstützung wird im Rahmen des [App-Prüfungsprozesses](https://docs.stripe.com/stripe-apps/review-requirements.md) überprüft. ### Verwaltete Sandbox Eine *verwaltete Sandbox* ist eine Sandbox, die Stripe automatisch in Ihrem Konto erstellt, um Ihre öffentliche Stripe-App zu unterstützen. - Stripe erstellt automatisch eine verwaltete Sandbox, wenn Sie zum ersten Mal eine öffentliche App hochladen. - Wenn ein/e Nutzer/in Ihre App in seiner/ihrer Sandbox installiert, wird eine Verbindung zu Ihrer verwalteten Sandbox hergestellt. - Sie können Ereignisse von Sandbox-Installation von Nutzer/innen innerhalb Ihrer verwalteten Sandbox [debuggen und überwachen](https://docs.stripe.com/workbench/guides.md). - Änderungen an einer verwalteten Sandbox haben keine Auswirkungen auf Nutzer/innen, die Ihre App im Live-Modus- oder in Test-Modus-Sandboxen installieren. - Sie können eine verwaltete Sandbox nicht löschen. ### Verwaltete Sandbox erstellen Stripe erstellt automatisch eine verwaltete Sandbox für Sie, wenn Sie zum ersten Mal [eine öffentliche Stripe-App](https://docs.stripe.com/stripe-apps/upload-install-app.md) in Ihr Konto hochladen. Für öffentliche Apps, die vor dem 3. Februar 2025 hochgeladen wurden, hat Stripe automatisch eine verwaltete Sandbox in Ihrem Konto erstellt. ## Allgemeine Sandbox-Installationen für Ihre öffentliche App aktivieren 1. Führen Sie `stripe apps -v` aus, um zu bestätigen, dass Sie die neueste Version von [Stripe CLI](https://docs.stripe.com/stripe-cli/upgrade.md) und [Stripe Apps Plugin](https://docs.stripe.com/stripe-apps/create-app.md#install-stripe-apps-cli) verwenden. Sie müssen vor dem Hochladen Ihrer App Version 1.5.23 oder höher haben. ```bash $ stripe plugin upgrade apps ✔ upgrade to v1.7.0 complete. $ stripe -v stripe version 1.25.1 $ stripe apps -v apps version 1.7.0 ``` 1. Aktualisieren Sie das App-Manifest, um Sandbox-Installationen zu unterstützen. 1. *(Optional)* Erstellen Sie Sandbox-spezifische Ereignis-Hooks in Ihrer verwalteten Sandbox. Aktualisieren Sie die serverseitige Logik, um diese neuen Endpoints zu überwachen. 1. *(Optional)* Aktualisieren Sie die serverseitige Logik so, dass Ihre [verwalteten Sandbox-API-Schlüssel](https://docs.stripe.com/sandboxes/dashboard/manage-access.md) verwendet werden, wenn Stripe-API-Aufrufe für eine Sandbox-Installation durchgeführt werden. 1. Laden Sie eine neue Version Ihrer App in Ihr Hauptkonto hoch (**nicht** in Ihre verwaltete Sandbox). 1. Erstellen Sie von Ihrem Hauptkonto aus [einen externen Testlink](https://docs.stripe.com/stripe-apps/test-app.md) für die Sandbox-fähige Version, die Sie soeben hochgeladen haben. 1. Erstellen und öffnen Sie eine neue Sandbox, um Ihre aktualisierte App zu testen. 1. Rufen Sie in einem Browserfenster den externen Testlink auf, den Sie zuvor erstellt haben, um Ihre App zu installieren. 1. Testen Sie, ob Ihre App wie erwartet funktioniert, wenn sie in einer Sandbox installiert ist. 1. Reichen Sie Ihre neue Version zur Überprüfung durch den Marktplatz ein. ### App-Manifest aktualisieren > Ab dem 3. Februar 2025 müssen Sie die Sandbox-Unterstützung im App-Manifest für die im Marktplatz veröffentlichten Apps als „true“ oder „false“ deklarieren. Um die Installation Ihrer App in einer Sandbox zu unterstützen, deklarieren Sie die Sandbox-Unterstützung im [App-Manifest](https://docs.stripe.com/stripe-apps/reference/app-manifest.md#schema) mit `sandbox_install_compatible`. Der folgende Beispielcode deklariert die Sandbox-Unterstützung: ```json { "id": "com.invoicing.[YOUR_APP]", "version": "1.2.3", "name": "[YOUR APP] Shipment Invoicing", "icon": "./[YOUR_APP]_icon_32.png", "distribution_type": "public", "sandbox_install_compatible": true } ``` ### Über Sandbox-Verbindungen Wenn ein/e Nutzer/in Ihre öffentliche App in seiner Sandbox installiert, wird eine Verbindung zu Ihrer verwalteten Sandbox hergestellt. Dies unterscheidet sich vom Verhalten, wenn Ihre App in Sandboxen im Live- oder Test-Modus installiert wird. - Wenn ein/e Nutzer/in eine App in einer Sandbox installiert, wird eine Verbindung zu Ihrer verwalteten Sandbox hergestellt. - Wenn ein/e Nutzer/in eine App im Live-Modus installiert, wird eine Verbindung zu Ihrer Sandbox für den Live- und Test-Modus hergestellt. - Wenn ein Nutzer eine App in einer Sandbox im Test-Modus installiert, wird eine Verbindung zu Ihrer Sandbox im Test-Modus hergestellt. ### Webhook-Ereignisse konfigurieren Wenn Ihre App Ereignisse aus den Installationen Ihrer Nutzer/innen überwacht, gibt es zusätzliche Einstellungen für den Umgang mit Apps, die in Sandboxes installiert wurden. - Erstellen Sie in Ihrer verwalteten Sandbox neue Webhooks für Sandbox-Ereignisse. - Wenn ein/e Nutzer/in Ihre App in einer Sandbox installiert, sendet Stripe alle zutreffenden Ereignisse nur an Ihre verwalteten Sandbox-Endpoints. - Passen Sie Ihre serverseitige Logik an, um sandboxspezifische Ereignisse zu verarbeiten. > Weitere Informationen darüber, wie sich der Installationsmodus auf das Ereignisverhalten auswirkt, finden Sie unter [Ereignisverhalten](https://docs.stripe.com/stripe-apps/build-backend.md#event-behavior-depends-on-install-mode). ### Signaturschlüssel abrufen Für Webhooks müssen Sie möglicherweise auch den [Signatur-Geheimschlüssel](https://docs.stripe.com/webhooks/signature.md#check-the-endpoint-secret) aus der verwalteten Sandbox abrufen. ### API-Schlüssel konfigurieren Ihre verwaltete Sandbox verfügt über eigene [API-Schlüssel](https://docs.stripe.com/keys.md) für Aufrufe im Zusammenhang mit Sandbox-Installationen. Bei der Reaktion auf sandboxspezifische Webhooks oder Ereignisse müssen Sie diese Schlüssel für die [verwaltete Sandbox](https://docs.stripe.com/sandboxes/dashboard/manage-access.md) verwenden. Sie finden die richtigen API Schlüssel für Sandbox-Installationen in Ihrer verwalteten Sandbox. ### Links zur OAuth-Sandbox finden Die OAuth-URLs für den Live-Modus, den Test-Modus und die allgemeine Sandbox finden Sie auf der Registerkarte [Externer Test](https://docs.stripe.com/stripe-apps/test-app.md) in Ihren App-Einstellungen. Wenn Ihre App RAK oder die Plattformauthentifizierung verwendet, sind keine Änderungen erforderlich. ## Ihre App in einer Sandbox testen Nachdem Sie Ihre App aktualisiert haben, um Sandbox-Installationen zu verarbeiten, können Sie Ihre App in Ihrer eigenen Sandbox testen. 1. Erstellen Sie von Ihrem Hauptkonto aus [einen externen Testlink](https://docs.stripe.com/stripe-apps/test-app.md) für die Sandbox-fähige Version, die Sie soeben hochgeladen haben. 1. Erstellen Sie eine neue Sandbox, um Ihre aktualisierte App zu testen. Öffnen Sie die neue Sandbox. 1. Öffnen Sie in einem neuen Browserfenster den externen Testlink, den Sie zuvor erstellt haben, um Ihre App zu installieren. 1. Testen Sie, ob Ihre in einer Sandbox installierte App erwartungsgemäß funktioniert. ### Sandbox-API-Schlüssel und das Verhalten von Webhooks überprüfen Sie können [Workbench](https://docs.stripe.com/workbench.md) verwenden, um zu validieren, dass Ihre Sandbox-Installation korrekt funktioniert. - Führen Sie in Ihrer *Test-Sandbox* einige Beispielaktionen aus. - Öffnen Sie als Nächstes Workbench in Ihrer *verwalteten Sandbox*. Verwenden Sie Workbench, um das Verhalten Ihrer App zu überprüfen, einschließlich der [Überprüfung von API-Logs](https://docs.stripe.com/workbench/guides.md#view-logs-by-source) und dem [Filtern von Ereignissen](https://docs.stripe.com/workbench/guides.md#filter-events). Wenn Sie Ihre App korrekt aktualisiert haben, können Sie alle API-Aufrufe und Webhook-Ereignisse für Ihre Beispielaktionen anzeigen. Sollten Sie die erwarteten Ereignisse oder Antworten nicht sehen, überprüfen Sie, ob Sie sich in Ihrer verwalteten Sandbox befinden. Vergewissern Sie sich außerdem, dass Sie Ihre sandboxspezifischen Webhook-Endpoints eingerichtet haben und dass Ihre Anwendung die richtigen Sandbox-API-Schlüssel verwendet. ### App zur Überprüfung einreichen Nachdem Sie die Sandbox-Unterstützung aktiviert und überprüft haben, ob Ihre App in einer Sandbox wie erwartet funktioniert, können Sie [Ihre App zur Überprüfung übermitteln](https://docs.stripe.com/stripe-apps/publish-app.md). Die Unterstützung der App-Sandbox wird im Rahmen der [App-Überprüfung](https://docs.stripe.com/stripe-apps/review-requirements.md) verifiziert und auf der Detailseite Ihres App-Eintrags aufgeführt.