Configurer le comportement des comptes connectés

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 actuelle est null) lors de l’ajout de la configuration Merchant à un compte. Vous devez également définir la valeur dashboard (si elle est null) lorsque vous demandez la fonctionnalité stripe_transfers pour la configuration du destinataire sur un compte. Choisissez parmi les 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 exigences KYC dépend des valeurs defaults.responsibilities.losses_collector et dashboard. Dans la plupart des configurations, Stripe est responsable de la collecte des exigences KYC auprès de vos comptes connectés. Votre plateforme n’est responsable que lorsque vous définissez defaults.responsibilities.losses_collector sur application et dashboard sur none. Vous pouvez vérifier cette configuration en consultant defaults.responsibilities.requirements_collector, dont la valeur peut être stripe ou application.

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	defaults.responsibilities.requirements_collector	Dans Accounts v2, cette valeur est calculée automatiquement à partir des paramètres `losses_collector` et `dashboard`. Vous ne pouvez pas la définir par vous-même.
controller.stripe_dashboard.type	dashboard	Indique l’accès du compte connecté aux Dashboards Stripe.