Deploy your app with the API

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.

Lors du déploiement, votre application est immédiatement envoyée et téléchargée sur votre appareil. L’appareil redémarre pour installer l’application. Toutes les 24 heures, les appareils redémarrent, puis recherchent et appliquent automatiquement les mises à jour. Pour rechercher les mises à jour et les appliquer immédiatement, vous pouvez redémarrer manuellement votre appareil.

Vous pouvez déployer des nouvelles applications et des mises à jour d’applications pour les appareils Terminal dans le Dashboard.

Ajouter ou modifier un groupe de déploiement

Avant de pouvoir ajouter ou modifier un groupe de déploiement, vous devez créer un emplacement et ajouter des lecteurs à cet emplacement. Vous pouvez ensuite affecter des emplacements à un groupe de déploiement. Tous les lecteurs affectés à un emplacement donné reçoivent les mises à jour de ce groupe de déploiement.

Une fois que vous avez créé un groupe de déploiement, vous pouvez le modifier à tout moment en le sélectionnant.

Ajouter un groupe de déploiement

1. Dans l’onglet Applications Terminal, cliquez sur Gérer des groupes de déploiement.
2. Cliquez sur Ajouter un groupe de déploiement.
3. Dans le volet Ajouter un groupe de déploiement, procédez comme suit :
   • Saisissez un nom pour le groupe.
   • Choisissez votre type d’appareil Terminal.
   • Si vous le souhaitez, cochez la case Groupe de déploiement par défaut pour créer un groupe de déploiement par défaut. Un groupe de déploiement par défaut contient automatiquement tous les emplacements qui ne sont pas explicitement attribués à un autre groupe de déploiement. Vous pouvez créer un groupe de déploiement par défaut par type d’appareil.
   • Cliquez sur Terminé.

Gérer les groupes de déploiement avec des paiements indirects

1. Dans l’onglet Applications Terminal, cliquez sur Gérer des groupes de déploiement.
2. Sélectionnez le groupe de déploiement dans la liste.
3. Cliquez sur Ajouter des emplacements.
4. Choisissez les emplacements à ajouter.
5. Cliquez sur Terminé.

Gérer les groupes de déploiement avec des paiements directs

1. Dans l’onglet Applications Terminal, cliquez sur Gérer des groupes de déploiement.
2. Sélectionnez le groupe de déploiement dans la liste.
3. Cliquez sur Ajouter des emplacements.
4. Sélectionnez le compte à partir duquel vous souhaitez ajouter des emplacements dans la liste déroulante des comptes. Vous devez sélectionner un compte avant d’ajouter des emplacements.
5. Choisissez les emplacements à ajouter.
6. Cliquez sur Terminé.

Déployer une version de l’application

Vous pouvez déployer votre application une fois qu’elle a été approuvée par Stripe.

1. Dans l’onglet Applications Terminal, choisissez l’application que vous souhaitez déployer.
2. Sur la page relative aux informations sur l’application, cliquez sur Déployer la version.
3. Choisissez une version de l’application approuvée, puis cliquez sur Suivant. Vous ne pouvez pas déployer une version antérieure d’une application : la version de l’application doit être plus récente que celle actuellement déployée.
4. Choisissez le groupe de déploiement, puis cliquez sur Suivant.
5. Choisissez votre application kiosque préférée, puis cliquez sur Suivant. Il s’agit de l’application qui se lance par défaut au démarrage du lecteur Stripe. S’il n’y a qu’une seule application à déployer, c’est celle-là que vous devez choisir.
6. Confirmez les détails du déploiement, puis cliquez sur Déployer. L’application est déployée immédiatement.

Partager des applications entre plusieurs comptes

Utilisez cette fonctionnalité si vous possédez plusieurs comptes Stripe et souhaitez déployer la même application sur plusieurs comptes. Le partage d’une application entre plusieurs comptes permet d’éviter les contraintes liées à l’unicité du nom du package et la duplication des avis d’utilisateur sur l’application.

Désignez un compte pour créer et gérer l’application. Seul le compte propriétaire de l’application peut charger de nouvelles versions de celle-ci, mais les autres comptes peuvent afficher et déployer l’application en recherchant son ID.

1. Dans l’onglet Applications Terminal, cliquez sur le menu de débordement ().
2. Cliquez sur Rechercher une application.
3. Saisissez l’ID de l’application, puis cliquez sur Afficher les informations concernant l’application.
4. Cliquez sur Déployer la version et saisissez les détails du déploiement.

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

{
  "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"
}

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

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

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

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

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

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]"=