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é a des exigences non encore satisfaites, la gestion des comptes intégrés invite le compte connecté à mettre à jour ses informations. Elle collecte toujours les exigences de type 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
• Restrictions relatives aux exigences granulaires

Restrictions relatives aux exigences

Lorsque vous spécifiez des options de collecte, vous pouvez configurer des limites pour les exigences précises en tant que uniquement ou exclure. Ces deux options permettent de spécifier un tableau de chaînes de caractères représentant les exigences currently_due ou eventually_due sur un compte. Pour plus de détails sur les exigences applicables à vos comptes connectés, consultez la section Informations de vérification requises.

Considérez les options comme des filtres, où la valeur exclure filtre les exigences de compte correspondantes, et n’agit que 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 uniquement : [« 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 exclure 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 exclure 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 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',
// })