# 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](https://docs.stripe.com/connect/account-balances.md) 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é](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md#kyc-requirements) 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.

> Les responsabilités et la propriété `dashboard` dans Accounts v2 correspondent aux [propriétés du contrôleur dans Accounts v1](https://docs.stripe.com/connect/migrate-to-controller-properties.md). Ce document inclut [un tableau de correspondance entre les propriétés du contrôleur et les propriétés Accounts v2](https://docs.stripe.com/connect/accounts-v2/connected-account-configuration.md#property-map).

## 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](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-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](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-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](https://docs.stripe.com/connect/risk-management.md) 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](https://docs.stripe.com/connect/integration-recommendations.md).

### Comportement de la commission de la plateforme

L’encaissement et le reporting des frais pour le paiement direct diffèrent selon votre [modèle de tarification](https://docs.stripe.com/connect/saas.md#monetization) et la façon dont vous configurez la responsabilité des frais. Si vous utilisez les commissions de la plateforme pour monétiser le traitement des paiements pour vos comptes connectés :

- Si vous définissez l’encaisseur des frais sur `stripe` dans Accounts v2 ou le payeur des frais sur `account` dans Accounts v1, Stripe déduit ses frais de traitement et votre commission de la plateforme du paiement, puis vous reverse votre part. Définissez le montant de la commission de la plateforme pour n’inclure que vos frais.
- Si vous définissez l’encaisseur des frais sur `application`, vous encaissez le paiement et les frais, puis vous payez à Stripe ses frais de traitement. Définissez le montant de la commission de la plateforme pour inclure à la fois vos frais et les frais de traitement Stripe.

Par exemple, si les frais de traitement Stripe sont de 1,00 et que vos frais sont de 1,50 supplémentaire, pour un coût total de 2,50 pour le compte connecté :

- Si Stripe encaisse les frais, définissez la commission de la plateforme sur 1,50. Stripe déduit ses frais de traitement séparément.
- Si votre plateforme encaisse les frais, définissez la commission de la plateforme sur 2,50 afin qu’elle couvre les deux frais.

> #### Modification de votre modèle de tarification
> 
> Si vous modifiez votre modèle de tarification ou la configuration de l’encaisseur des frais, vous risquez de facturer un montant trop ou pas assez élevé à vos comptes connectés. Assurez-vous que la configuration de votre compte connecté applique les coûts de traitement comme prévu en examinant vos commissions de la plateforme et votre modèle de tarification avant de définir ou de modifier vos responsabilités.

## Définir l’accès au Dashboard

Vous devez définir la valeur de la propriété [dashboard](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-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](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-configuration-recipient-capabilities-stripe_balance-stripe_transfers-requested) pour la configuration du destinataire sur un compte. Choisissez parmi les valeurs suivantes :

- `express` : le compte connecté peut accéder au [Dashboard Stripe Express](https://docs.stripe.com/connect/express-dashboard.md), 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](https://docs.stripe.com/connect/stripe-dashboard.md). 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](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) pour fournir à vos comptes connectés des fonctionnalités similaires dans une interface personnalisée.

Pour plus d’informations sur les configurations prises en charge, consultez les [recommandations d’intégration](https://docs.stripe.com/connect/integration-recommendations.md).

## 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`.

> 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](https://docs.stripe.com/connect/handle-verification-updates.md).

## 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](https://docs.stripe.com/api/accounts/create.md?api-version=preview#create_account-controller-fees-payer) | [defaults.responsibilities.fees_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-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](https://docs.stripe.com/api/accounts/create.md?api-version=preview#create_account-controller-losses-payments) | [defaults.responsibilities.losses_collector](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-defaults-responsibilities-losses_collector) | Définit la responsabilité en cas de soldes négatifs encourus par le compte connecté. |
| [controller.requirement_collection](https://docs.stripe.com/api/accounts/create.md?api-version=preview#create_account-controller-requirement_collection) | [defaults.responsibilities.requirements_collector](https://docs.stripe.com/api/v2/core/accounts/object.md#v2_account_object-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](https://docs.stripe.com/api/accounts/create.md?api-version=preview#create_account-controller-stripe_dashboard-type) | [dashboard](https://docs.stripe.com/api/v2/core/accounts/create.md#v2_create_accounts-dashboard) | Indique l’accès du compte connecté aux Dashboards Stripe. |