# Gestion des comptes

Affichez les informations relatives au compte et donnez la possibilité de les modifier.

La gestion des comptes affiche un composant d’interface utilisateur permettant aux comptes connectés de modifier les informations de leur compte de manière proactive. Les comptes connectés peuvent afficher et modifier les informations de compte, telles que les informations personnelles ou professionnelles, les informations publiques et les comptes bancaires qu’ils utilisent pour les virements.

La gestion des comptes n’est pas optimisée pour la collecte des informations manquantes et ne gère pas la [vérification des risques](https://docs.stripe.com/connect/handling-api-verification.md#handle-risk-verifications). Pour ces cas d’usage, envisagez d’utiliser [l’inscription de compte](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) ou la [bannière de notification](https://docs.stripe.com/connect/supported-embedded-components/notification-banner.md).

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

## Options de collecte des exigences

Lorsqu’un compte connecté présente des [exigences](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-requirements) non satisfaites, la gestion du compte invite son titulaire à mettre à jour ses informations. Elle collecte toujours les exigences `currently_due`, et vous pouvez utiliser l’attribut `collectionOptions` pour effectuer également l’une des requêtes suivantes :

- Exigences de type `eventually_due`
- [Exigences futures](https://docs.stripe.com/connect/handle-verification-updates.md)
- [Restrictions relatives aux exigences](https://docs.stripe.com/connect/supported-embedded-components/account-management.md#requirement-restrictions) granulaires

### Restrictions relatives aux exigences

Lorsque vous spécifiez des options de recouvrement, vous pouvez configurer des limites pour les exigences précises en tant que `only` ou `exclude`. Les deux options acceptent un tableau de chaînes de caractères représentant les propriétés requises telles qu’elles apparaissent dans `requirements.entries[].description` pour les comptes v2 et les différents tableaux de prérequis pour les comptes v1. Pour plus de détails sur les exigences applicables à vos comptes connectés, consultez la section [Informations de vérification requises](https://docs.stripe.com/connect/required-verification-information.md).

Considérez les options comme des filtres, où la valeur `exclude` filtre les exigences de compte correspondantes, et n’agit `only` comme une intersection entre les exigences de compte et les valeurs spécifiées. Elles prennent également en charge la correspondance par caractères génériques à l’aide de `*` et des préfixes de relation.

Par exemple, si vous avez un compte connecté avec plusieurs propriétaires, vous pouvez collecter les informations d’adresse de tous les propriétaires en spécifiant `only: ["owners.address.*"]`.

Une personne peut avoir plusieurs relations associées, et les relations peuvent être attribuées à plusieurs personnes. Par conséquent, lorsque vous utilisez des préfixes de relation, ceux-ci s’appliquent à toutes les personnes du compte ayant la relation spécifiée. Cela est particulièrement utile lorsque vous ne connaissez pas l’ID d’une personne en particulier, mais que vous connaissez sa relation.

Considérations importantes

- Les comptes doivent encore répondre à toutes les exigences KYC pour que les fonctionnalités soient activées. L’option `exclude` ne supprime pas une exigence, elle empêche seulement le recouvrement à ce moment-là. Les informations doivent tout de même être collectées.
- Ces restrictions s’appliquent uniquement aux composants intégrés. Elles n’affectent pas les comptes utilisant d’autres types de Dashboard.
- Cette fonctionnalité vise à améliorer l’expérience utilisateur, et non à empêcher les comptes d’accéder aux informations.

#### seule exigence restrictive

Cette option étend le recouvrement à l’ensemble des exigences en attente sur le compte. Elle est principalement utilisée pour créer une expérience de rectification et est particulièrement utile pour les exigences nécessitant une vérification d’identité ou le chargement de documents.

Cette option empêche la composante d’intégration de compte d’afficher l’Étape de synthèse finale standard. Si toutes les exigences spécifiées ont été fournies, la composante d’intégration de compte se ferme immédiatement.

#### exclure la restriction des exigences

Cette option permet de masquer les champs spécifiés, ce qui empêche un compte connecté de fournir ou de modifier ces informations. Elle ne supprime pas les exigences en matière d’informations, mais masque uniquement les champs du composant. Cette option est utile lorsque vous souhaitez préremplir des informations auxquelles vous ne voulez pas que le compte connecté accède lors de l’inscription des utilisateurs.

Pour les comptes Express, si vous souhaitez `exclude` l’exigence `business_type` (par exemple, pour empêcher un compte de modifier le type de l’entreprise), le pays du compte et les fonctionnalités doivent être définis.

## Champs affichés

Les [champs](https://docs.stripe.com/connect/required-verification-information.md) affichés par le composant de gestion de compte dépendent de la manière dont vous avez configuré le compte connecté, en particulier pour le pays du compte connecté, le type d’entreprise, les fonctionnalités et le type de contrat de service. Ceci est similaire à la façon dont le [composant d’inscription des utilisateurs](https://docs.stripe.com/connect/supported-embedded-components/account-onboarding.md) ne collecte que les informations nécessaires à la configuration du compte connecté.

## Collecte de comptes externes

Utilisez la fonctionnalité [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_management-features-external_account_collection) pour contrôler si le composant collecte des informations sur les comptes externes. Ce paramètre est activé par défaut. Lorsque le paramètre `external_account_collection` est activé, [l’authentification de l’utilisateur](https://docs.stripe.com/connect/get-started-connect-embedded-components.md#user-authentication-in-connect-embedded-components) est requise. Vous pouvez désactiver l’authentification utilisateur Stripe à l’aide du paramètre [disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_management-features-disable_stripe_user_authentication).

## Désactiver l’authentification utilisateur Stripe

Utilisez la fonctionnalité [disable_stripe_user_authentication](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_management-features-disable_stripe_user_authentication) pour contrôler si le composant nécessite l’authentification utilisateur Stripe.

- Par défaut, le paramètre `disable_stripe_user_authentication` est l’opposé de la valeur [external_account_collection](https://docs.stripe.com/api/account_sessions/create.md#create_account_session-components-account_management-features-external_account_collection).
- Si vous ne définissez pas le paramètre `external_account_collection`, sa valeur par défaut est vraie, par conséquent, le paramètre `disable_stripe_user_authentication` est défini par défaut sur faux.

- Lorsque le paramètre `controller.requirement_collection` est défini sur `stripe`, les deux valeurs sont définies par défaut sur faux.

Cette valeur ne peut être vraie que pour les comptes où le paramètre `controller.requirement_collection` a la valeur `application`.

Nous vous recommandons de mettre en œuvre l’authentification à deux facteurs ou des mesures de sécurité équivalentes à titre de [bonne pratique](https://docs.stripe.com/connect/risk-management/best-practices.md#prevent-account-take-overs). Pour les configurations de compte qui prennent en charge cette fonctionnalité, comme les comptes Custom, vous assumez la responsabilité des comptes connectés s’ils ne sont pas en mesure de rembourser les [soldes négatifs](https://docs.stripe.com/connect/risk-management/best-practices.md#decide-your-approach-to-negative-balance-liability).

### Créer une session de compte

Lorsque vous [créez une session de compte](https://docs.stripe.com/api/account_sessions/create.md), activez la gestion des comptes en spécifiant `account_management` dans le paramètre `components`.

```curl
curl https://api.stripe.com/v1/account_sessions \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "account={{CONNECTEDACCOUNT_ID}}" \
  -d "components[account_management][enabled]=true" \
  -d "components[account_management][features][external_account_collection]=true"
```

### Afficher le composant de gestion de compte

#### JavaScript

```js
// Include this element in your HTML
const accountManagement = stripeConnectInstance.create('account-management');
container.appendChild(accountManagement);

// Optional:
// accountManagement.setCollectionOptions({
//   fields: 'eventually_due',
//   futureRequirements: 'include',
// })
```

#### HTML + JS

| Méthode                | Type                                                                                                                                              | Description                                                                                                                                                                                                         | Par défaut                                              |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
| `setCollectionOptions` | `{fields: 'currently_due' | 'eventually_due', future_requirements: 'omit' | 'include', requirements: { exclude: string[] } | { only: string[] }}` | Indique s’il faut collecter les exigences `eventually_due` et inclure `future_requirements`. Le fait de spécifier `eventually_due` permet de collecter à la fois les exigences `eventually_due` et `currently_due`. | `{fields: 'currently_due', futureRequirements: 'omit'}` |

#### React

| Propriété React     | Type                                                                                                                                               | Description                                                                                                                                                                                                                                                                                               | Par défaut                                              | Obligatoire ou facultatif |
| ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------- | ------------------------- |
| `collectionOptions` | `{fields: 'currently_due' | 'eventually_due', futureRequirements?: 'omit' | 'include', requirements?: { exclude: string[] } | { only: string[] }}` | Indique s’il faut collecter les exigences `eventually_due` et inclure `future_requirements`. Le fait de spécifier `eventually_due` permet de collecter à la fois les exigences `eventually_due` et `currently_due`. Vous ne pouvez pas mettre à jour ce paramètre après l’affichage initial du composant. | `{fields: 'currently_due', futureRequirements: 'omit'}` | facultatif                |