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.

L’attribut informations envoyées

Le composant de gestion de compte s’affiche uniquement pour les comptes dont l’attribut details_submitted est défini sur true. Si un compte n’a pas fait l’objet d’une inscription des utilisateurs, le composant de gestion de compte ne s’affichera pas. Dans ce cas, nous recommandons d’utiliser le composant d’inscription des utilisateurs.

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é.

External account collection

Use the external_account_collection feature to control whether the component collects external account information. This parameter is enabled by default, and only platforms responsible for collecting updated information when requirements are due or change (including Custom accounts) can disable it. When external_account_collection is enabled, user authentication is required. You can opt out of Stripe user authentication with the disable_stripe_user_authentication parameter.

Disable Stripe user authentication

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.

We recommend implementing 2FA or equivalent security measures as a best practice. For account configurations that support this feature, such as Custom accounts, you assume liability for connected accounts if they can’t pay back negative balances.

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',
// })