# 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) 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 offre aux comptes connectés un ensemble complet de fonctionnalités, y compris la consultation des paiements, la gestion des remboursements et des litiges, l’accès aux rapports et le traitement des paiements de manière autonome. Les utilisateurs peuvent se connecter à leur Dashboard Stripe à tout moment et y accéder directement depuis le site de Stripe. Les utilisateurs ont accès au service Support de Stripe, et Stripe peut les contacter et communiquer avec eux au sujet de leur compte. Utilisez le Dashboard Stripe lorsque : - Vos utilisateurs doivent avoir accès à de puissants flux de paiements et à des fonctions avancées de gestion des utilisateurs. - Vous préférez que Stripe gère le risque de perte et prenne la responsabilité des soldes négatifs sur les comptes connectés. - L’image de marque de Stripe et le co-branding limité de la plateforme ne vous posent aucun problème. 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 Donner accès au Dashboard Express aux comptes connectés afin qu’ils gèrent leur compte. Le Dashboard Express permet aux comptes connectés de consulter leur solde disponible, de consulter les virements à venir et de suivre leurs gains en temps réel. Les utilisateurs ne peuvent pas gérer les remboursements ou les litiges via le Dashboard Express. Ils ont accès au service Support de Stripe, et Stripe peut les contacter et communiquer avec eux au sujet de leur compte. Utilisez le Dashboard Express lorsque : - Vos utilisateurs sont des vendeurs de places de marché qui ont besoin d’un accès limité aux workflows. - Vous envoyez principalement des paiements à ces utilisateurs, ils ne gèrent pas directement les remboursements ou les litiges. - Vous souhaitez personnaliser entièrement l’apparence du Dashboard. - Vous êtes prêt à prendre la responsabilité du solde négatif et à gérer le risque de perte sur les comptes connectés. 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 en même temps que l’accès au Dashboard Stripe. #### 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. ### 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. À moins que vous ne soyez éligible aux [virements internationaux](https://docs.stripe.com/connect/cross-border-payouts.md), votre plateforme et le compte connecté sur lequel vous transférez des fonds doivent se trouver dans la même région pour vous permettre de 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. À moins que vous ne soyez éligible aux [virements internationaux](https://docs.stripe.com/connect/cross-border-payouts.md), votre plateforme et le compte connecté sur lequel vous transférez des fonds doivent se trouver dans la même région pour vous permettre d’utiliser des paiements et des 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) #### Item 2 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### Item 3 (See full diagram at https://docs.stripe.com/connect/design-an-integration) #### 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) ### 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 places de marché qui collectent les paiements des acheteurs pour les reverser aux vendeurs, ou pour les plateformes avancées qui souhaitent avoir un contrôle total sur la manière dont les risques et les responsabilités sont gérés sur les 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 #### 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.