# Définir des actions et des configurations post-installations

Prenez en charge des configurations supplémentaires qui surviennent après l'installation de l'application.

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](https://docs.stripe.com/stripe-apps/components/settingsview.md)
- 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.

(See full diagram at https://docs.stripe.com/stripe-apps/post-install-actions)

```text
[Action post-installation ?] -- Non (par défaut) --> [L’utilisateur peut utiliser l’application]
[Action post-installation ?] -- Oui (externe) --> [L’utilisateur a la possibilité de consulter un site externe]
[Action post-installation ?] -- Oui (dans l’application) --> [Possibilité donnée à l’utilisateur d’accéder à l’inscription ou aux paramètres de l’application]
[L’utilisateur installe l’application] --> [Action post-installation ?]
```

## Ajouter une action post-installation

Pour ajouter une action post-installation :

1. Ouvrez votre fichier du [manifeste de l’application](https://docs.stripe.com/stripe-apps/reference/app-manifest.md).

2. Ajoutez un nouveau champ, `post_install_action`.

   ```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](https://docs.stripe.com/stripe-apps/post-install-actions.md#configuration-options) pour l’action `post_install_action` qui répond aux besoins de configuration de votre application.

4. [Chargez](https://docs.stripe.com/stripe-apps/upload-install-app.md) votre application sur Stripe.

5. [Créez un nouveau build](https://docs.stripe.com/stripe-apps/versions-and-releases.md) de votre application.

6. [Publiez](https://docs.stripe.com/stripe-apps/publish-app.md) votre application sur la place de marché.

## Options de configuration

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

- [Associer à l’application](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-app)
- [Associer à une application pleine page](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-fullpage)
- [Associer à l’onboarding](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-onboarding)
- [Associer aux paramètres](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-settings)
- [Associer à une URL externe](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-external)

### Associer à 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.
![Écran post-installation avec un lien pour afficher une application](https://b.stripecdn.com/docs-statics-srv/assets/app.09cbbc38c50cfef0a9aaf9a92f8d1d0e.png)

Cette option ne requiert aucune configuration supplémentaire.

### Associer à une application pleine page

Pour ouvrir la [vue pleine page](https://docs.stripe.com/stripe-apps/patterns/full-page-apps.md) de votre application immédiatement après l’installation, lancez-la avec l’action `fullpage`. Votre application doit également définir un viewport [stripe.dashboard.fullpage](https://docs.stripe.com/stripe-apps/reference/viewports.md). Pour activer ce flux, mettez à jour le paramètre `post_install_action` dans le fichier manifeste de votre application.

```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": {
    "type": "fullpage"
  }
}
```

### Associer à l’onboarding

Pour demander à votre utilisateur d’effectuer les tâches de configuration avant d’utiliser votre application, lancez le [flux d’inscription](https://docs.stripe.com/stripe-apps/patterns/onboarding-experience.md) immédiatement après l’installation de l’application. Pour activer ce flux, mettez à jour le paramètre `post_install_action` dans le fichier du manifeste de votre application.

```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": {
    "type": "onboarding"
  }
}
```

### Associer à une 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 :

```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": {
    "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
```
![Écran post-installation avec un lien externe](https://b.stripecdn.com/docs-statics-srv/assets/external.565e55096589e7c7580bc5d534c1ace1.png)

### Associer aux paramètres

Si votre application contient un composant [SettingsView](https://docs.stripe.com/stripe-apps/components/settingsview.md), 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 :

```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": {
    "type": "settings"
  }
}
```

Lorsque l’utilisateur installe votre application, cette dernière affiche un bouton qui le redirige vers le composant SettingsView de votre application.
![Écran post-installation avec un lien pour afficher les paramètres](https://b.stripecdn.com/docs-statics-srv/assets/settings.e6bc859871bc657c25d353055497c8ee.png)