Gestion des comptes

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. Pour ces cas d’usage, envisagez d’utiliser l’inscription de compte ou la bannière de notification.

Options de collecte des exigences

Lorsqu’un compte connecté présente des exigences en attente, la gestion intégrée des comptes invite le compte connecté à mettre à jour ses informations. L’attribut collectionOptions permet de contrôler la collecte des exigences currently_due ou eventually_due, et d’inclure ou non les exigences futures.

Champs affichés

Les champs 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 ne collecte que les informations nécessaires à la configuration du compte connecté.

Collecte de comptes externes

Utilisez la fonctionnalité external_account_collection pour contrôler si le composant collecte ou non des informations sur les comptes externes. Ce paramètre est activé par défaut, et seules les plateformes chargées de collecter les informations à jour lorsque les exigences sont insatisfaites ou évoluent (y compris les comptes Custom) peuvent le désactiver. Lorsqu’external_account_collection est activé, l’authentification de l’utilisateur est requise. Vous pouvez désactiver l’authentification de l’utilisateur de Stripe avec le paramètre disable_stripe_user_authentication.

Désactiver l’authentification utilisateur Stripe

Utilisez la fonctionnalité disable_stripe_user_authentication pour contrôler si le composant nécessite une authentification utilisateur Stripe. La valeur par défaut est l’opposé de la valeur external_account_collection. Par exemple, si vous ne définissez pas external_account_collection, sa valeur est définie sur « true » par défaut, et disable_stripe_user_authentication est défini par défaut sur « false ». Cette valeur ne peut être « true » que pour les comptes pour lesquels controller.requirement_collection est application.

Nous vous recommandons de mettre en œuvre l’authentification à deux facteurs ou des mesures de sécurité équivalentes à titre de bonne pratique. 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.

Créer une session de compte

Lorsque vous créez une session de compte, activez la gestion des comptes en spécifiant account_management dans le paramètre components.

curl https://api.stripe.com/v1/account_sessions \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}} \
  -d "components[account_management][enabled]"=true \
  -d "components[account_management][features][external_account_collection]"=true

Afficher le composant de gestion de compte

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

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