Weiter zum Inhalt
Konto erstellen
 oder
anmelden
Das Logo der Stripe-Dokumentation
/
Konto erstellen
Anmelden
ÜbersichtAktualisieren Sie Ihre Integration
Online-Zahlungen
ÜbersichtIhren Use case finden
Zahlungsmethoden
Nutzeroberflächen für Zahlungen
Zahlungsszenarien
Präsenzzahlungen
Terminal
Andere Stripe-Produkte

Deploy your app with the API

Learn how to deploy your Android app to your devices through a webhook.

After Stripe reviews and approves your app for deployment, we notify you by email through a webhook. You can then follow the instructions below to deploy your app.

Während der Bereitstellung wird Ihre App sofort gesendet und auf Ihr Gerät heruntergeladen. Das Gerät wird neu gestartet, um die App zu installieren. Geräte werden alle 24 Stunden neu gestartet und automatisch aktualisiert. Um sofort nach Updates zu suchen und diese anzuwenden, können Sie Ihr Gerät manuell neu starten.

Sie können neue und aktualisierte Apps für Terminal-Geräte im Dashboard bereitstellen.

Bereitstellungsgruppe hinzufügen oder bearbeiten

Bevor Sie eine Bereitstellungsgruppe hinzufügen oder bearbeiten können, müssen Sie einen Terminal-Standort erstellen und diesem Standort Lesegeräte hinzufügen. Sie können dann einer Bereitstellungsgruppe Standorte zuweisen, sodass alle Lesegeräte am Standort Aktualisierungen von dieser Bereitstellungsgruppe erhalten.

Nachdem Sie eine Bereitstellungsgruppe erstellt haben, können Sie sie jederzeit bearbeiten, indem Sie sie auswählen.

Bereitstellungsgruppe hinzufügen

  1. Klicken Sie auf der Registerkarte Terminal-Apps auf Bereitstellungsgruppen verwalten.
  2. Klicken Sie auf Bereitstellungsgruppe hinzufügen.
  3. Führen Sie die folgenden Schritte im Drawer Bereitstellungsgruppe hinzufügen aus:
    • Geben Sie einen Gruppennamen ein.
    • Wählen Sie Ihren Terminal-Gerätetyp aus.
    • Aktivieren Sie bei Bedarf das Kontrollkästchen Standardbereitstellungsgruppe, um eine Standardbereitstellungsgruppe zu erstellen. Eine Standardbereitstellungsgruppe enthält automatisch alle Standorte, die nicht explizit einer anderen Bereitstellungsgruppe zugewiesen sind. Sie können eine Standardbereitstellungsgruppe pro Gerätetyp erstellen.
    • Klicken Sie auf Fertig.

Bereitstellungsgruppen mit Destination Charges verwalten

  1. Klicken Sie auf der Registerkarte Terminal-Apps auf Bereitstellungsgruppen verwalten.
  2. Wählen Sie die Bereitstellungsgruppe aus der Liste aus.
  3. Klicken Sie auf Standorte hinzufügen.
  4. Wählen Sie die hinzuzufügenden Standorte aus.
  5. Klicken Sie auf Fertig.

Bereitstellungsgruppen mit Direct Charges verwalten

  1. Klicken Sie auf der Registerkarte Terminal-Apps auf Bereitstellungsgruppen verwalten.
  2. Wählen Sie die Bereitstellungsgruppe aus der Liste aus.
  3. Klicken Sie auf Standorte hinzufügen.
  4. Wählen Sie in der Konto-Dropdown-Liste das Konto aus, von dem Sie Standorte hinzufügen möchten. Sie müssen ein Konto auswählen, bevor Sie Standorte hinzufügen können.
  5. Wählen Sie die hinzuzufügenden Standorte aus.
  6. Klicken Sie auf Fertig.

App-Version bereitstellen

Sie können Ihre App bereitstellen, nachdem sie von einem/einer Stripe-Prüfer/in genehmigt wurde.

  1. Wählen Sie auf der Registerkarte Terminal-Apps die App aus, die Sie bereitstellen möchten.
  2. Klicken Sie auf der Seite mit App-Details auf Version bereitstellen.
  3. Wählen Sie eine Version der genehmigten App aus und klicken Sie dann auf Weiter. Sie können keine frühere Version einer App bereitstellen – die App-Version muss neuer sein als die aktuell bereitgestellte App.
  4. Wählen Sie die Bereitstellungsgruppe aus und klicken Sie dann auf Weiter.
  5. Wählen Sie Ihre bevorzugte Kiosk-App aus und klicken Sie dann auf Weiter. Dies ist die Standard-App, die beim Einschalten des Stripe Lesegeräts gestartet wird. Wenn Sie nur eine App bereitstellen müssen, wählen Sie stattdessen diese aus.
  6. Bestätigen Sie die Bereitstellungsdetails und klicken Sie dann auf Bereitstellen. Die App wird sofort bereitgestellt.

Apps für mehrere Konten freigeben

Verwenden Sie diese Funktion, wenn Sie mehrere Stripe-Konten haben und dieselbe App kontenübergreifend bereitstellen möchten. Durch die gemeinsame Nutzung einer App für mehrere Konten werden Einschränkungen durch die Eindeutigkeit des Paketnamens und doppelte App-Überprüfungen vermieden.

Legen Sie ein Konto zum Erstellen und Verwalten der App fest. Nur das Konto, dem die App gehört, kann neue App-Versionen hochladen, aber andere Konten können die App anzeigen und bereitstellen, indem sie nach der App-ID suchen.

  1. Klicken Sie auf der Registerkarte Terminal-Apps auf das Überlaufmenü ().
  2. Klicken Sie auf Nach App suchen.
  3. Geben Sie die App-ID ein und klicken Sie auf App-Details anzeigen.
  4. Klicken Sie auf Bereitstellungsversion und geben Sie die Bereitstellungsdetails ein.

Stellen Sie Ihre App auf Geräten bereit, indem Sie eine Gerätebereitstellungsgruppe erstellen und diese mit einem Standort verknüpfen.

Gerätebereitstellungsgruppe erstellen

Erstellen Sie eine Gerätebereitstellungsgruppe mit einem bestimmten name und device_type.

Command Line
curl https://api.stripe.com/v1/terminal/device_deploy_groups \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2025-01-27.acacia; terminal_deploy_api_beta=v1" \
  -d name=my_toy_store_ddg \
  -d device_type=stripe_s700

The following response shows a tmddg_... identifier that you used to create the deployment plan.

{
  "id": "tmddg_EuEMSgeudJ0Zyw",
  "object": "terminal.device_deploy_group",
  "current_device_asset_versions": [],
  "device_type": "stripe_s700",
  "is_default": false,
  "livemode": false,
  "name": "my_toy_store_ddg"
}

Add readers to the device deploy group

Verwenden Sie die Standort-API, um Geräte zu einer Gerätebereitstellungsgruppe hinzuzufügen. Sie können das Feld device_deploy_groups für einen Standort festlegen, um der Gerätebereitstellungsgruppe einen device_type zuzuordnen.

Die Deploy API unterstützt den Gerätetyp stripe_s700 (verwendet von Stripe S700-Produktionsgeräten) und den Gerätetyp stripe_s700_devkit (verwendet von DevKit-Geräten).

Command Line
curl https://api.stripe.com/v1/terminal/locations/tml_EUmKfAsUh3 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2025-01-27.acacia; terminal_deploy_api_beta=v1" \
  -d "device_deploy_groups[stripe_s700]"=tmddg_EuEMSgeudJ0Zyw

Bei der Bereitstellung einer Geräte-Asset-Version für eine Bereitstellungsgruppe prüft die API, ob der Parameter compatible_device_types mit dem device_type der Bereitstellungsgruppe übereinstimmt.

Standard-App festlegen

Use the preferred_kiosk_app parameter to set the default app that launches on your devices.

Command Line
curl https://api.stripe.com/v1/terminal/deploy_plans \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2025-01-27.acacia; terminal_deploy_api_beta=v1" \
  -d device_deploy_group=tmddg_EuEMSgeudJ0Zyw \
  -d "device_asset_versions_to_install[]"=tmdav_5300BozlU0005TThQ5411LAZYXcVxtG \
  -d "device_asset_versions_to_install[]"=tmdav_5300QO3Ea0005SSea9p11HdL2OHx9Vf \
  -d preferred_kiosk_app=tmda_5300slhdm0005YeJakU11De7w9i9cLi

App aktualisieren

Use the device_asset_versions_to_install parameter to update the device asset version on your devices.

Command Line
curl https://api.stripe.com/v1/terminal/deploy_plans \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2025-01-27.acacia; terminal_deploy_api_beta=v1" \
  -d device_deploy_group=tmddg_EuEMSgeudJ0Zyw \
  -d "device_asset_versions_to_install[]"=tmdav_5300BozlU0005TThQ5411LAZYXcVxtG \
  -d "device_asset_versions_to_install[]"=tmdav_5300QO3Ea0005SSea9p11HdL2OHx9Vf \
  -d "device_asset_versions_to_install[]"=tmdav_5300d2sWI0015SS1YVA11HdL2OHx9Vf \
  -d preferred_kiosk_app=tmda_5300slhdm0005YeJakU11De7w9i9cLi

After you deploy your app, you can monitor its progress.

App deinstallieren

Verwenden Sie den Parameter device_assets_to_uninstall, um Ihre App auf Ihren Geräten zu deinstallieren.

Command Line
curl https://api.stripe.com/v1/terminal/deploy_plans \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2025-01-27.acacia; terminal_deploy_api_beta=v1" \
  -d device_deploy_group=tmddg_EuEMSgeudJ0Zyw \
  -d "device_asset_versions_to_install[]"=tmdav_5300BozlU0005TThQ5411LAZYXcVxtG \
  -d "device_asset_versions_to_install[]"=tmdav_5300QO3Ea0005SSea9p11HdL2OHx9Vf \
  -d "device_assets_to_uninstall[]"=tmda_5300slhdm0005YeJakU11De7w9i9cLi \
  -d preferred_kiosk_app=tmda_5300OPKai0005SiSmpV11HdL2OHx9Vf

Stripe Reader-App starten

Sie können Ihre Gerätebereitstellungsgruppe zurücksetzen, um die Stripe Reader-App anstelle Ihrer bevorzugten Kiosk-App zu starten.

Verwenden Sie in einer einzelnen Anfrage den Parameter device_assets_to_uninstall zum Deinstallieren der App und setzen Sie dann den Parameter preferred_kiosk_app auf STRIPE_APP (Groß-/Kleinschreibung beachten). Vergewissern Sie sich, dass sich keine Apps von Drittanbietern in der Gerätebereitstellungsgruppe befinden.

Command Line
curl https://api.stripe.com/v1/terminal/deploy_plans \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2025-01-27.acacia; terminal_deploy_api_beta=v1" \
  -d device_deploy_group=tmddg_EuEMSgeudJ0Zyw \
  -d "device_assets_to_uninstall[]"=tmda_5300slhdm0005YeJakU11De7w9i9cLi \
  -d preferred_kiosk_app=STRIPE_APP

Lesegeräte aus einer Gerätebereitstellungsgruppe entfernen

Um Lesegeräte aus einer Gerätebereitstellungsgruppe zu entfernen, legen Sie den Parameter device_deploy_groups auf einen Standort fest, um einen device_type einer leeren Zeichenfolge zuzuordnen.

Command Line
curl https://api.stripe.com/v1/terminal/locations/tml_EUmKfAsUh3 \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -H "Stripe-Version: 2025-01-27.acacia; terminal_deploy_api_beta=v1" \
  -d "device_deploy_groups[stripe_s700]"=

Best Practices für die Bereitstellungsgruppe

Sie können die Geräte in verschiedene Bereitstellungsgruppen einteilen, um die Software unabhängig voneinander bereitzustellen und Fehler zu isolieren, falls Probleme auftreten. Je nach Tools, Risikotoleranz und spezifischen Geschäftsanforderungen können Sie weniger oder mehr Bereitstellungsgruppen einrichten.

Wir empfehlen die folgende Einrichtung der Bereitstellungsgruppe:

  • Alpha: Enthält Standorte, die Ihren internen Devkits oder internen Produktionsgeräten entsprechen.
  • Beta: Enthält eine kleine Anzahl tatsächlicher Nutzerstandorte. Sie können diese Standorte nach dem Zufallsprinzip oder anhand aussagekräftiger Kriterien (z. B. Standorte mit geringerem Risiko) auswählen oder die Nutzer/innen basierend auf ihrer Risikotoleranz in die Beta-Bereitstellungsgruppe aufnehmen.
  • Allgemein: Enthält alle verbleibenden tatsächlichen Nutzerstandorte, mit Ausnahme der Alpha- oder Beta-Gruppen. Sie können eine Standardbereitstellungsgruppe verwenden, um die manuelle Zuweisung jedes verbleibenden Standorts zu vermeiden.

Wenn Ihre App bereit für die Bereitstellung ist, stufen Sie die Bereitstellungsgruppen von denjenigen mit dem geringsten Risiko zu denjenigen mit dem höchsten Risiko hoch:

1AlphaStellen Sie die App zunächst in der Alpha-Bereitstellungsgruppe bereit, um sie so zu testen, dass das Risiko für die Nutzer/innen minimiert wird. Die Erkennung eines Fehlers oder eines unerwünschten Verhaltens in dieser Phase betrifft nur eine kleine Anzahl interner Geräte und nicht tatsächliche Nutzer/innen und echte Zahlungen.
2BetaZweitens: Stellen Sie die Beta-Bereitstellungsgruppe bereit. Dadurch wird sichergestellt, dass Ihre Anwendung echten Nutzern und Nutzerinnen zugänglich ist und nicht alle Nutzer/innen potenziellen Problemen ausgesetzt werden.
3AllgemeinStellen Sie abschließend die allgemeine Bereitstellungsgruppe bereit, nachdem Sie etwaige Probleme behoben haben oder überprüft haben, dass für die Beta-Bereitstellungsgruppe keinen Probleme aufgetreten sind.

Nächster Schritt

War diese Seite hilfreich?
JaNein
Benötigen Sie Hilfe? Kontaktieren Sie den Kundensupport.
Nehmen Sie an unserem Programm für frühzeitigen Zugriff teil.
Schauen Sie sich unseren Produkt-Changelog an.
Fragen? Sales-Team kontaktieren.
Unterstützt von Markdoc