Configurer le comportement des comptes connectésVersion bêta publique

Découvrez comment configurer vos comptes connectés à l’aide de l’API Accounts v2.

Vous définissez les interactions entre votre plateforme, les comptes connectés et Stripe, telles que les flux de fonds et la responsabilité en cas de perte, en configurant vos comptes connectés. Configurez votre intégration pour les définir en précisant des valeurs pour certaines propriétés lorsqu’elle crée les objets Accounts v2 correspondants. Par exemple, les propriétés du hachage defaults.responsibilities attribuent la responsabilité des soldes négatifs sur vos comptes connectés et indiquent comment Stripe perçoit les frais de paiement.

Les valeurs que vous attribuez aux propriétés de votre compte connecté ont également une incidence sur d’autres aspects de votre intégration. Par exemple, la responsabilité de la vérification des informations d’identité est attribuée à Stripe ou à votre plateforme en fonction de la responsabilité des soldes négatifs et de l’accès des comptes connectés aux Dashboards Stripe.

Remarque

Les responsabilités et la propriété dashboard dans Accounts v2 correspondent aux propriétés du contrôleur dans Accounts v1. Ce document inclut un tableau de correspondance entre les propriétés du contrôleur et les propriétés Accounts v2.

Définir les responsabilités

Vous devez définir des propriétés defaults.responsibilities lorsque vous ajoutez la configuration du marchand à un compte. Vous ne pourrez pas mettre à jour leurs valeurs ultérieurement.

Propriété	Description	Valeurs
defaults.responsibilities.fees_collector	Définit la manière dont Stripe perçoit les frais de paiement pour les paiements directs sur le compte connecté. (Pour les paiements indirects ou distincts, Stripe prélève toujours les frais auprès de votre plateforme.)	`application` : votre plateforme prélève une commission de plateforme auprès de ses comptes connectés, tandis que Stripe débite votre plateforme des frais de paiement. `stripe` : Stripe prélève les frais de paiement directement auprès du compte connecté.
defaults.responsibilities.losses_collector	Attribue la responsabilité des soldes négatifs encourus par le compte connecté.	`application` : votre plateforme est responsable des soldes négatifs et gère les risques pour le compte connecté. `stripe` : Stripe assume la responsabilité des soldes négatifs des comptes connectés. Votre plateforme reste responsable des éventuels soldes négatifs sur votre compte de plateforme.

Les responsabilités sont soumises aux restrictions suivantes :

Si vous définissez losses_collector sur application, vous devez également définir fees_collector sur application.
Si vous utilisez des paiements indirects avec un compte, nous vous recommandons de définir à la fois losses_collector et fees_collector sur application.

Pour plus d’informations sur les configurations prises en charge, consultez les recommandations d’intégration.

Définir l’accès au Dashboard

Vous devez définir la valeur de la propriété dashboard (si sa valeur existante est nulle) lorsque vous ajoutez la configuration Marchand à un compte. Vous devez également définir la valeur dashboard (si sa valeur existante est nulle) lorsque vous demandez la fonctionnalité stripe_transfers pour la configuration Destinataire sur un compte. Choisissez l’une des valeurs suivantes :

express : le compte connecté peut accéder au Dashboard Stripe Express, dont les fonctionnalités sont limitées. Vous pouvez personnaliser son apparence avec l’image de marque de votre plateforme.
full : le compte connecté peut accéder au Dashboard Stripe complet. Le Dashboard Stripe complet permet à vos comptes connectés de consulter et de gérer leurs finances et leurs rapports.
none : le compte connecté ne peut accéder à aucun des deux Dashboards Stripe. Votre plateforme doit fournir toutes les fonctionnalités liées à Stripe.

Quel que soit le paramètre dashboard, votre plateforme peut utiliser des composants intégrés Connect pour fournir à vos comptes connectés des fonctionnalités similaires dans une interface personnalisée.

Les tableaux de bord sont soumis aux restrictions suivantes :

Si vous définissez dashboard sur express, vous devez également définir losses_collector et fees_collector sur application.
Si vous définissez dashboard sur full, vous devez également définir losses_collector et fees_collector sur stripe.

Pour plus d’informations sur les configurations prises en charge, consultez les recommandations d’intégration.

Recueillir les informations KYC (Know Your Customer)

La responsabilité de la collecte des informations KYC est basée sur les valeurs defaults.responsibilities.losses_collector et dashboard. Dans la plupart des configurations, Stripe est responsable de la collecte des informations KYC auprès de vos comptes connectés. Votre plateforme n’est responsable que si vous définissez defaults.responsibilities.losses_collector sur application et dashboard sur none.

Remarque

Configurez la responsabilité de la plateforme pour la collecte des exigences uniquement si vous êtes prêt à gérer la complexité opérationnelle requise pour vérifier les informations sur les exigences et maintenir la conformité avec toutes leurs mises à jour.

Tableau de correspondance des propriétés du contrôleur Accounts v1

Les paramètres décrits dans ce document correspondent aux propriétés du contrôleur Accounts v1 comme suit :

Propriété Accounts v1	Propriété Accounts v2	Description
controller.fees.payer	defaults.responsibilities.fees_collector	Définit qui perçoit les frais de paiement pour les paiements directs sur le compte connecté. (Pour les paiements indirects, Stripe perçoit toujours les frais auprès de votre plateforme.)
controller.losses.payments	defaults.responsibilities.losses_collector	Définit la responsabilité en cas de soldes négatifs encourus par le compte connecté.
controller.requirement_collection	S. O.	Dans Accounts v2, cette responsabilité est calculée sur la base des valeurs `losses_collector` et `dashboard`.
controller.stripe_dashboard.type	dashboard	Indique l’accès du compte connecté aux Dashboards Stripe.