# Concevoir une intégration avancée de Connect en utilisant l'API Accounts v1

Découvrez d'autres combinaisons de configurations pour une intégration Connect établie sur l’API Accounts v1.

> #### Intégrations API Accounts v2
> 
> Ce guide s’applique uniquement aux plateformes Connect existantes qui utilisent l’API Comptes v1.Si vous êtes un nouvel utilisateur Connect, utilisez plutôt l’API Comptes v2. Pour savoir comment configurer une plateforme Connect avec l’API Comptes v2, consultez le [guide de plateforme interactive](https://docs.stripe.com/connect/interactive-platform-guide.md).

Utilisez ce guide pour explorer différentes intégrations Connect et créer une liste d’étapes d’intégration personnalisées. Avant de commencer votre intégration dans un *environnement de test* (A sandbox is an isolated test environment that allows you to test Stripe functionality in your account without affecting your live integration. Use sandboxes to safely experiment with new features and changes), vous devez [créer un compte Stripe ou vous connecter](https://dashboard.stripe.com) et [inscrire votre plateforme à Connect](https://dashboard.stripe.com/settings/connect/platform-profile).

## Sélectionner les propriétés

### Créer et inscrire des comptes

Stripe vous permet de créer des comptes au nom des utilisateurs, appelés comptes connectés. Lorsque vous utilisez Connect, vous devez créer un compte connecté pour chaque utilisateur recevant des fonds sur votre plateforme.



#### Item 1

Envoyez vos comptes connectés vers un flux d’inscription hébergée par Stripe. L’inscription hébergée par Stripe vous permet de rediriger votre utilisateur vers Stripe pour terminer le processus d’inscription dans une interface co-marquée.
![Capture d'écran du formulaire Connect Onboarding](https://b.stripecdn.com/docs-statics-srv/assets/Kavholm-Seamless-Standard.78b64d90c0bf87130c8b6ba1ef53df7f.png)

Idéal pour un lancement rapide avec un minimum d’efforts d’intégration :

- Les comptes connectés quittent votre site et sont redirigés vers Stripe pour terminer le flux.
- Co-marquage avec Stripe et options de personnalisation limitées.
- Stripe gère toute la logique du flux d’inscription.
- Prend automatiquement en charge plus de 46 pays et 14 langues.

#### Item 2

Intégrez une interface d’inscription hautement personnalisable avec un marquage Stripe limité directement dans votre application. Les utilisateurs de comptes connectés interagissent avec le composant intégré sans jamais quitter votre application. Vous pouvez ajouter l’inscription intégrée en quelques lignes de code.

Note: The following is a preview/demo component that behaves differently than live mode usage with real connected accounts. The actual component has more functionality than what might appear in this demo component. For example, for connected accounts without Stripe dashboard access (custom accounts), no user authentication is required in production.

Idéal pour garder les utilisateurs sur votre site avec une expérience plus intégrée et un faible effort d’intégration :

- Les comptes connectés restent sur votre site.
- Très personnalisable. Image de marque Stripe limitée ou absente.
- Stripe gère toute la logique du flux d’inscription.
- Prend automatiquement en charge plus de 46 pays et 14 langues.

#### Item 3

Développez chaque aspect du flux d’inscription en appelant les API Stripe correspondantes. Vous devez créer une logique personnalisée dans votre intégration pour satisfaire toutes les informations de vérification requises.

> #### Recommandation de Stripe
> 
> La création et la maintenance d’un flux d’intégration d’API nécessitent des ressources importantes et des mises à jour régulières. Si vous souhaitez mettre en place un flux d’inscription personnalisé, Stripe vous conseille vivement d’utiliser l’[inscription intégrée](https://docs.stripe.com/connect/embedded-onboarding.md).

(See full diagram at https://docs.stripe.com/connect/design-an-integration)

```text
[Inscrire un nouveau compte connecté] --> [Afficher l’interface utilisateur pour collecter les requirements de votre compte connecté]
[Afficher l’interface utilisateur pour collecter les requirements de votre compte connecté] --> [Créer un compte connecté]
[Créer un compte connecté] --> [Si requirements.currently_due n’est pas vide]
[Récupérer le compte connecté] --> [Si requirements.currently_due n’est pas vide]
[Présenter des formulaires pour collecter les informations et valider des champs] --> [Mettre à jour le compte connecté avec les informations collectées]
[Réinscrire un compte connecté existant] --> [Récupérer le compte connecté]
[Mettre à jour le compte connecté avec les informations collectées] --> [Si requirements.currently_due n’est pas vide]
[Si requirements.currently_due n’est pas vide] --> [Présenter des formulaires pour collecter les informations et valider des champs]
```

Idéal pour avoir un contrôle total sur le flux d’inscription :

- Développez et gérez vous-même toute la logique du flux d’inscription. Cela peut nécessiter beaucoup de ressources et coûter cher.
- Vous gérez les risques en assumant l’entière responsabilité des soldes négatifs des comptes connectés.
- Vous devrez mettre vos flux à jour à mesure que les exigences de vérification évoluent et créer également des flux supplémentaires pour communiquer et satisfaire ces exigences auprès de vos utilisateurs. Examinez et mettez à jour les exigences d’inscription au moins tous les six mois pour vous assurer que votre flux tient compte des exigences les plus récentes.
- Vous devez créer un formulaire personnalisé pour collecter des informations de comptes bancaires ou de cartes de débit afin que les comptes connectés puissent être configurés avec un compte de virement.

### Mise en place des flux du tableau de bord

Les comptes connectés doivent avoir accès à un tableau de bord pour gérer leur compte. Fournissez aux comptes connectés un accès au Dashboard Stripe, au Dashboard Express ou à un tableau de bord créé à l’aide de l’API Stripe et de composants intégrés. 

#### Item 1

Donnez accès au Dashboard Stripe aux comptes connectés.

Le Dashboard Stripe donne aux comptes connectés un accès illimité à l’ensemble des fonctionnalités de Stripe à l’aide de leurs propres identifiants de connexion. Les comptes connectés peuvent se connecter directement sur dashboard.stripe.com à tout moment. Ils ont accès au service de support Stripe, et Stripe peut communiquer avec eux au sujet de leur compte.

Utilisez le Dashboard Stripe lorsque vos comptes connectés :

- Doivent gérer leurs propres clés d’API, webhooks ou intégrations de développeur.
- Ont besoin de rapports financiers détaillés ou d’exporter des données.
- Ont des équipes avec des besoins d’accès différents (par exemple, des rôles d’administrateur et d’analyste distincts).
- Utilisent Stripe Apps.

Vous pouvez toujours ajouter des [composants intégrés](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) à votre propre site web tout en fournissant l’accès au Dashboard Stripe.

#### Item 2

Donnent accès au Dashboard Express aux comptes connectés afin qu’ils gèrent leur compte.

Le Dashboard Express est un Dashboard hébergé par Stripe aux fonctionnalités limitées, que vous pouvez personnaliser selon votre image de marque et en configurant les fonctionnalités qu’il prend en charge. Les comptes connectés qui utilisent le Dashboard Express ont accès au service de support Stripe, et Stripe peut communiquer avec eux au sujet de leur compte.

Utilisez le Dashboard Express lorsque vos comptes connectés :

- Ont principalement besoin de suivre leurs virements et leur activité de paiement.
- N’ont pas besoin d’outils de développement ou de reporting avancés.
- Peuvent utiliser une interface utilisateur simple et épurée.

Vous pouvez [configurer le Dashboard Express](https://docs.stripe.com/connect/customize-express-dashboard.md#customize-features) pour personnaliser les fonctionnalités, telles que les litiges, les remboursements et les virements manuels, auxquelles vos comptes connectés peuvent accéder. Les comptes connectés accèdent au Dashboard Express via un [lien de connexion](https://docs.stripe.com/api/accounts/login_link/create.md) que vous générez, plutôt que de se connecter directement sur dashboard.stripe.com.

Vous pouvez toujours ajouter des [composants intégrés Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) à votre propre site web tout en fournissant un accès au Dashboard Express.

#### Item 3

Créez un Dashboard à l’aide des API Stripe ou de composants intégrés pour permettre aux comptes connectés de gérer leur compte.

Les comptes connectés n’auront accès ni au Dashboard Stripe ni au Dashboard Express. C’est à vous de donner l’accès à ces workflows lorsque vous créez le Dashboard, les workflows de remboursement et de litige de votre utilisateur ainsi que les fonctionnalités de reporting. Vos utilisateurs ne se rendent peut-être pas compte qu’ils disposent d’un compte Stripe par le biais de votre plateforme.

Nous vous recommandons d’intégrer des [composants intégrés Connect](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) pour ajouter des fonctionnalités du Dashboard à votre application de plateforme avec un faible effort d’intégration. Les composants intégrés sont hautement personnalisables et peuvent prendre en charge les comptes connectés avec :

- Workflows de paiement tels que la consultation des paiements et des virements, la gestion des remboursements et la réponse aux litiges
- Workflows de virement tels que la gestion de la fréquence des virements, la création de virements manuels ou la mise à jour des comptes de virement
- Workflows de reporting pour télécharger et exporter les paiements et les virements
- Workflows de gestion de compte tels que la mise à jour des informations sur l’entreprise

> Pour un compte sans accès au Dashboard hébergé par Stripe où Stripe est responsable des soldes négatifs, utilisez les composants intégrés Connect pour fournir des mises à jour de compte en libre-service. Vous ne pouvez pas créer [Liens de compte](https://docs.stripe.com/api/liens_compte.md) du type `account_update` pour ces comptes.

> #### Le type de Dashboard est immuable
> 
> Le Dashboard que vous spécifiez lors de la création d’un compte connecté est permanent. Tenez compte des besoins à long terme de votre entreprise lorsque vous choisissez le type de Dashboard. Pour modifier le Dashboard d’un compte connecté, vous devez créer un nouvel objet `Account`.

### Accepter un paiement

Vous créez un paiement pour accepter un paiement d’un client au nom de votre compte connecté. Le type de paiement que vous créez :

- Détermine la répartition des fonds de paiement entre toutes les parties concernées
- A une incidence sur la façon dont les frais apparaissent sur le relevé bancaire ou de facturation du client (avec les informations de votre plateforme ou celles de votre utilisateur)
- Détermine le compte Stripe débité du coût des remboursements et des contestations de paiement



#### Item 1

Un paiement direct est un paiement effectué par un client directement sur un compte connecté. Les clients effectuent des transactions directement avec votre compte connecté, souvent sans connaître l’existence de votre plateforme.

Ce type de paiement est le mieux adapté aux plateformes SaaS. Par exemple, Shopify fournit des outils pour créer des vitrines en ligne et Thinkific permet aux enseignants de vendre des cours en ligne.

#### Item 2

Créez des paiements indirects sur votre plateforme et transférez immédiatement des fonds vers des comptes connectés. Les clients effectuent des transactions sur votre plateforme pour des biens ou services proposés par vos comptes connectés.

Ce type de paiement est le mieux adapté aux places de marché telles qu’Airbnb (location de logements) ou Lyft (covoiturage).

Les paiement indirects sont créés sur la plateforme, mais dans le cadre de l’opération de paiement, les fonds sont immédiatement transférés sur le compte connecté que vous avez défini. Vous pouvez décider de transférer une partie ou la totalité de ces fonds.

Sauf si vous êtes éligible aux [virements transfrontaliers Connect](https://docs.stripe.com/connect/connect-cross-border-payouts.md), votre plateforme et le compte connecté auquel vous transférez des fonds doivent se trouver dans la même région pour créer un paiement indirect. Toute tentative de transfert de fonds au-delà d’une frontière non autorisée renvoie une erreur.

#### Item 3

Créez des paiements et transferts distincts pour transférer des fonds vers plusieurs comptes connectés, ou lorsque l’utilisateur spécifique n’est pas connu au moment du paiement. Le paiement sur votre compte de plateforme est dissocié des transferts vers vos comptes connectés.

Ce type de frais convient mieux aux places de marché qui doivent répartir les paiements entre plusieurs parties, comme DoorDash, une plateforme de livraison de plats à domicile.

Si les paiements et transferts distincts offrent une grande souplesse, une intégration plus complexe est nécessaire pour gérer les soldes des comptes entre votre plateforme et vos utilisateurs. Vous devez surveiller attentivement le solde du compte de votre plateforme pour vous assurer que vous disposez de fonds suffisants pour couvrir le montant du transfert.

Sauf si vous êtes éligible aux [virements transfrontaliers Connect](https://docs.stripe.com/connect/connect-cross-border-payouts.md), votre plateforme et le compte connecté auquel vous transférez des fonds doivent se trouver dans la même région pour utiliser les paiements et transferts distincts. Toute tentative de transfert de fonds au-delà d’une frontière non autorisée renvoie une erreur.

### Frais Stripe



#### Item 1

Stripe collecte les frais Stripe sur le compte de votre plateforme, y compris les frais de traitement. C’est vous qui contrôlez les montants des frais de traitement que vous facturez aux comptes connectés. Utilisez le paramètre de commission de la plateforme pour collecter les frais de traitement auprès de vos comptes connectés.

#### Item 1

(See full diagram at https://docs.stripe.com/connect/design-an-integration)

```text
[customer] -- Paiement direct --> [Paiement de 10 USD]
[Paiement de 10 USD] --> [Commission de la plateforme de 0,59 USD]
[Paiement de 10 USD] -- 9,41 USD nets --> [bank]
[Commission de la plateforme de 0,59 USD] -- (0,23 USD) Stripe --> [stripe]
[Commission de la plateforme de 0,59 USD] -- 0,36 USD net --> [bank]
[account]
[platform]
```

#### Item 2

(See full diagram at https://docs.stripe.com/connect/design-an-integration)

```text
[customer] --> [Paiement de 10 USD]
[Paiement de 10 USD] --> [Transfert de 10 USD]
[Transfert de 10 USD] --> [Paiement de 10 USD]
[Paiement de 10 USD] --> [(1,23 USD) Commission de la plateforme]
[(1,23 USD) Commission de la plateforme] --> [8,77 USD net]
[(1,23 USD) Commission de la plateforme] --> [Commission de la plateforme de 1,23 USD]
[Commission de la plateforme de 1,23 USD] --> [(0,59 USD) Frais Stripe]
[(0,59 USD) Frais Stripe] --> [stripe]
[(0,59 USD) Frais Stripe] --> [0,64 USD nets]
[platform]
[account]
```

#### Item 3

(See full diagram at https://docs.stripe.com/connect/design-an-integration)

```text
[customer] --> [Paiement de 100 USD]
[Paiement de 100 USD] --> [(70 USD) Transfert]
[(70 USD) Transfert] --> [Paiement de 70 USD]
[(70 USD) Transfert] --> [(20 USD) Transfert]
[(20 USD) Transfert] --> [(20 USD) Paiement]
[(20 USD) Transfert] --> [(3,20 USD) Frais Stripe]
[(3,20 USD) Frais Stripe] --> [stripe]
[(3,20 USD) Frais Stripe] --> [6,80 USD nets]
[platform]
[account]
[account]
```

#### Item 2

Stripe collecte les frais Stripe directement depuis vos comptes connectés. Vous pouvez prélever une commission de la plateforme facultative lorsque vous créez le paiement direct.

(See full diagram at https://docs.stripe.com/connect/design-an-integration)

```text
[customer] -- Paiement direct --> [Paiement de 10 USD]
[Paiement de 10 USD] --> [(1,23 USD) Commission de la plateforme]
[(1,23 USD) Commission de la plateforme] --> [Commission de la plateforme de 1,23 USD]
[Commission de la plateforme de 1,23 USD] --> [platform]
[(1,23 USD) Commission de la plateforme] --> [(0,59 USD) Frais Stripe]
[(1,23 USD) Commission de la plateforme] --> [8,18 USD nets]
[(0,59 USD) Frais Stripe] --> [stripe]
[account]
```

### Envoyer des virements aux utilisateurs

Lorsque les fonds issus du paiement sont versés et que le compte connecté de votre utilisateur a un solde Stripe positif, vous pouvez virer ces fonds sur son compte externe.

#### Item 1

Si vous procédez à l’inscription d’utilisateurs dans votre propre flux à l’aide de l’API Stripe, vous devez également collecter des comptes bancaires ou des cartes de débit pour configurer vos comptes connectés avec un compte de virement. Lorsque vous avez collecté les informations de l’utilisateur pour le compte de virement, joignez-le en tant que compte externe. Les virements sont bloqués si votre compte Connecté n’a pas de compte externe vérifié.

#### Item 2

#### Item 3

Par défaut, les fonds qui ont été versés sur les soldes de vos comptes connectés sont virés quotidiennement par Stripe. Si vous le souhaitez, vous pouvez configurer différentes fréquences de virement automatique, déclencher des virements manuellement plutôt qu’automatiquement, ou encore effectuer des virements instantanés.

### Responsabilité des soldes négatifs



#### Item 1

Votre plateforme est responsable des pertes occasionnées par les soldes négatifs de vos comptes connectés. Votre plateforme est responsable de l’examen des nouveaux comptes connectés lors de l’inscription et de la détermination du profil de risque de vos utilisateurs.

Recommandé pour les marketplaces qui collectent les paiements des clients avant de verser leur part aux commerçants, ou pour les plateformes avancées qui souhaitent contrôler entièrement la gestion des risques et des soldes négatifs de leurs comptes connectés :

- Votre plateforme doit surveiller les comptes connectés pour s’assurer qu’il n’y a pas de risque de perte.
- Votre plateforme doit créer des flux pour communiquer et résoudre les problèmes des comptes connectés lorsque vous détectez une fraude ou un risque.
- Vous disposez à la fois de l’équipe opérationnelle et des ressources techniques pour mettre en place des processus de gestion du risque de perte et de prévention de la fraude.

Avant de créer des comptes avec cette configuration, reconnaissez et considérez avec circonspection les responsabilités de votre plateforme en matière de solde négatif.

#### Item 2

Stripe surveille les signaux de risque sur vos comptes connectés, intervient en cas de risque et cherche à recouvrer les soldes négatifs de vos comptes connectés.

Pour la plupart des plateformes SaaS, il s’agit du meilleur choix par défaut, en particulier pour celles qui débutent dans l’intégration des paiements :

- Stripe surveille les risques de crédit et de fraude sur vos comptes connectés et assure une protection contre les risques de perte en cas de soldes négatifs imputables à des risques commerciaux.
- Stripe gère toutes les communications et mesures correctives de bout en bout directement avec vos comptes connectés via des flux hébergés ou des composants intégrés.

#### Item 1

> #### Version bêta de l’API requise avec le Dashboard Express
> 
> L’association de l’accès au Dashboard Express et de la responsabilité de Stripe pour les soldes négatifs est en [version bêta publique](https://docs.stripe.com/release-phases.md). Utilisez la chaîne de version bêta actuelle (`2026-10-28.preview`) dans la configuration de votre SDK Stripe lors de la création de comptes connectés.
> 
> Le code et le prompt générés sur cette page utilisent la version actuelle de l’API généralement disponible. Remplacez cette version par la chaîne de version bêta si vous utilisez cette combinaison.

#### Item 2

#### Item 3

#### Item 1

#### Composants intégrés requis

Lorsque Stripe est responsable des soldes négatifs sur vos comptes connectés, vous devez inclure des composants intégrés pour l’inscription, la gestion des comptes et la bannière de notification.

Stripe utilise le composant de bannière de notification intégré pour notifier les comptes connectés des exigences en suspens ou d’autres demandes liées à la gestion des risques. Le composant de gestion de compte est nécessaire pour que vos comptes connectés puissent gérer leurs identifiants d’authentification et leurs informations d’entreprise.

Stripe envoie également des e-mails en votre nom à vos comptes connectés pour gérer les risques et garantir le maintien de la conformité. Vous pouvez personnaliser et marquer ces communications par e-mail avec votre propre domaine de messagerie et votre propre marque de plateforme.

Pour tout autre composant facultatif, vous pouvez également utiliser des [composants intégrés](https://docs.stripe.com/connect/get-started-connect-embedded-components.md) ou créer votre propre interface utilisateur.

#### Item 2

#### Item 3

## Étapes d’intégration pour vos sélections

Les étapes d’intégration suivantes dépendent des options que vous avez sélectionnées ci-dessus. Vous pouvez visualiser les différentes étapes en sélectionnant différentes options au-dessus ou dans le panneau à droite des étapes. Les options de cette page contrôlent uniquement les étapes affichées ci-dessous. Elles n’affectent pas la configuration de votre plateforme.

Le bouton suivant génère une invite LLM en fonction de vos sélections. Il ne prend en charge que le Dashboard hébergé par Stripe et l’inscription des utilisateurs hébergée.