Définir des actions et des configurations post-installations

Une fois qu’un utilisateur a installé votre application, vous pouvez lui demander d’effectuer des actions ou des configurations supplémentaires selon vos besoins. Par exemple, l’utilisateur peut être invité à fournir des identifiants distincts pour autoriser votre application à accéder à un service externe. Stripe Apps fait référence à ces étapes supplémentaires en tant qu’actions post-installation. Vous pouvez configurer des actions post-installation :

• Dans l’application-même, en utilisant un composant SettingsView
• En-dehors de l’application, en utilisant un lien vers un site web externe

Si vous ne définissez pas d’action post-installation, le Dashboard affiche l’application après l’installation.

Ajouter une action post-installation

Pour ajouter une action post-installation :

1. Ouvrez votre fichier du manifeste de l’application.

2. Ajoutez un nouveau champ, post_install_action.

   stripe-app.json

   {
     "id": "com.invoicing.[YOUR_APP]",
     "version": "1.2.3",
     "name": "[YOUR APP] Shipment Invoicing",
     "icon": "./[YOUR_APP]_icon_32.png",
     "permissions": [],
     "app_backend": {},
     "ui_extension": {},
     "post_install_action": {}
   }
   

3. Ajoutez l’option de configuration pour l’action post_install_action qui répond aux besoins de configuration de votre application.

4. Chargez votre application sur Stripe.

5. Créez un nouveau build de votre application.

6. Publiez votre application sur la place de marché.

Options de configuration

Stripe Apps prend en charge les actions post-installation suivantes :

• Lien vers l’application
• Lien vers les paramètres
• Lien vers l’URL externe

Lien vers l’application (par défaut)

Une fois que l’utilisateur a installé votre application, il est redirigé par défaut vers l’interface de votre application, le cas échéant.

Cette option ne requiert aucune configuration supplémentaire.

Lien vers l’URL externe

Si vous avez besoin que l’utilisateur accède à un site externe pour configurer son application, mettez à jour le paramètre post_install_action dans le fichier du manifeste de l’application de la manière suivante :

{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},
  "post_install_action": {
    "type": "external",
    "url": "https://[YOUR-URL]"
  }
}

Remplacez [YOUR-URL] par l’URL du site externe.

Lorsque l’utilisateur installe votre application, cette dernière affiche un bouton qui le redirige vers l’URL indiquée dans le fichier du manifeste de l’application.

Cette URL contient un paramètre account_id de la chaîne de requête que vous pouvez utiliser pour identifier l’utilisateur. Par exemple :

https://www.company.com/marketplace/stripe?account_id=12345

Lien vers les paramètres

Si votre application contient un composant SettingsView, vous pouvez configurer une post_install_action afin de déclencher son ouverture une fois l’installation terminée. Pour ce faire, mettez à jour le fichier de votre manifeste d’application comme suit :

{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},
  "post_install_action": {
    "type": "settings"
  }
}

Lorsque l’utilisateur installe votre application, cette dernière affiche un bouton qui le redirige vers le composant SettingsView de votre application.