Fonctionnement des comptes connectés

Pour utiliser Financial Accounts pour les plateformes, votre plateforme doit disposer d’une intégration Stripe Connect. Stripe Connect permet à une plateforme de fournir des comptes connectés aux marchands et aux fournisseurs de services. Pour un aperçu de la façon dont les comptes connectés s’intègrent dans la structure des comptes Financial Accounts pour les plateformes, consultez le guide sur la structure des comptes Financial Accounts pour les plateformes.

Financial Accounts pour les plateformes prend uniquement en charge les comptes connectés qui n’utilisent pas de Dashboard hébergé par Stripe et pour lesquels votre plateforme est responsable du recouvrement des exigences et de la responsabilité des pertes, y compris les comptes connectés Custom. Découvrez comment créer des comptes connectés compatibles avec Financial Accounts pour les plateformes.

En tant que plateforme disposant de comptes connectés, vous êtes responsable du maintien d’une version API minimale, de la communication des mises à jour des conditions d’utilisation du service à vos comptes connectés, du traitement des demandes d’informations de leur part et de leur fournir un service de support. Étant donné que votre plateforme est en dernier ressort responsable des pertes subies par vos comptes connectés, vous êtes également responsable de leur vérification afin de détecter toute fraude. Pour en savoir plus, consultez le guide sur la fraude relative à Financial Accounts pour les plateformes .

Pour profiter pleinement de Financial Accounts pour les plateformes, vous devez activer certaines fonctionnalités spécifiques sur vos comptes connectés. Différentes fonctionnalités nécessitent différentes capacités, qui peuvent exiger des informations supplémentaires sur les propriétaires des comptes connectés. La fonctionnalité trésorerie, par exemple, est une exigence applicable aux comptes connectés pour avoir accès à Financial Accounts pour les plateformes. Lorsque vous demandez la fonctionnalité trésorerie pour un compte, vous devez renseigner des champs supplémentaires avant que le compte puisse utiliser Financial Accounts pour les plateformes.

Avant de créer des comptes connectés en mode production pour votre intégration de Financial Accounts pour les plateformes, nous vous conseillons de créer d’abord des comptes connectés de test dans un environnement de test. Les comptes connectés de test ne peuvent pas recevoir ni envoyer de fonds réels, ni être utilisés en mode production, mais leur configuration et leurs fonctionnalités sont identiques à celles des modes production.

Vérifier le type de vos comptes connectés existants

Si votre plateforme dispose déjà d’une intégration Connect avec des comptes connectés mais que vous avez un doute sur leur type, vous pouvez utiliser le Dashboard ou l’API pour récupérer ces informations.

Créer un nouveau compte connecté avec la fonctionnalité Treasury

Utilisez POST /v1/accounts pour créer un nouveau compte connecté. Demandez les fonctionnalités suivantes pour le compte, nécessaires pour l’utilisation de Financial Accounts pour les plateformes :

• transfers (requis pour tous les comptes connectés)
• treasury

Si vous souhaitez émettre des cartes pour votre compte connecté via Stripe Issuing, vous devez également demander la fonctionnalité card_issuing. Pour en savoir plus, consultez notre guide relatif à l’utilisation des cartes Issuing de Stripe.

Si vous souhaitez transférer des fonds via le réseau ACH vers ou depuis un compte externe, vous devez également demander la fonctionnalité us_bank_account_ach_payments.

Voici un exemple de requête regroupant toutes les options citées précédemment :

Sauf échec de l’opération, la réponse confirme la création du compte connecté et l’activation de la fonctionnalité capabilities demandée.

Pour en savoir plus sur les fonctionnalités des comptes connectés, consultez le guide Fonctionnalités du compte pour Connect.

Mettre à jour un compte connecté pour intégrer la fonctionnalité Treasury

Si l’un de vos comptes connectés dispose déjà de la fonctionnalité card_payments activée, utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} pour mettre à jour le compte avec l’ID associé en demandant la fonctionnalité treasury. La requête suivante demande la fonctionnalité treasury pour un compte connecté et inclut les fonctionnalités facultatives card_issuing et us_bank_account_ach_payments :

Utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} pour mettre à jour les fonctionnalités des comptes connectés pour lesquels un FinancialAccount a déjà été attribué. Pour en savoir plus, consultez la documentation API Utilisation des comptes financiers ou l’objet FinancialAccount.

Inscrire le compte connecté

Après avoir créé un compte, vous devez procéder à l’inscription du marchand ou fournisseur de service qui en sera propriétaire. L’objet Account, qui représente le compte connecté, possède un hachage requirements ; celui-ci contient les exigences de vérification d’identité currently_due. Le marchand ou le fournisseur de services de votre plateforme doit renseigner les informations détaillées requises dans le hachage requirements afin d’activer les paiements et les virements sur son compte connecté, ainsi que toutes les fonctionnalités demandées pour son compte financier.

Deux options s’offrent à vous pour l’inscription des utilisateurs titulaires de comptes connectés aux Financial Accounts pour les plateformes : inscription des utilisateurs hébergée et inscription des utilisateurs Custom. Nous recommandons l’inscription des utilisateurs hébergée.

Si vous créez un objet Account de test et que vous souhaitez contourner les exigences d’inscription des utilisateurs pour tester la fonctionnalité, utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} pour fournir des valeurs de test qui répondent à toutes les exigences. La requête suivante utilise un compte connecté créé précédemment afin de fournir les informations requises sur le compte.

Utilisation de l’inscription hébergée

Utilisez Connect Onboarding pour collecter efficacement les informations requises. Ainsi, Stripe traite les aspects complexes de la vérification et collecte l’acceptation des conditions d’utilisation du service. Vous pouvez également rédiger vos propres requêtes à l’API pour l’intégration initiale et continuer à surveiller les évolutions des exigences de conformité pour maintenir votre flux d’inscription des utilisateurs à jour. Découvrez comment créer des comptes connectés compatibles avec Financial Accounts pour les plateformes.

Avant de pouvoir utiliser Connect Onboarding, vous devez définir le nom, la couleur et l’icône de votre marque dans la section Marque de la page de paramètres Connect. Vous pourrez ainsi personnaliser l’apparence du formulaire d’inscription à votre plateforme présenté aux marchands et fournisseurs de services.

Pour tirer parti de Connect Onboarding, utilisez POST /v1/account_links pour créer un attribut AccountLink à fournir au marchand ou au fournisseur de services qui va devenir propriétaire du compte connecté :

Le résultat contient l’URL à partager à votre utilisateur.

Utiliser l’inscription intégrée

L’inscription intégrée est une interface utilisateur d’inscription personnalisable avec un marquage Stripe limité. Elle vous offre plus de contrôle sur l’expérience utilisateur que la solution d’inscription hébergée de Stripe. Avec l’inscription intégrée des utilisateurs, vous bénéficiez d’un flux d’inscription personnalisé, sans la complexité et les efforts qu’impliquerait la mise à jour de votre intégration d’inscription à chaque évolution des exigences de conformité.

Votre plateforme intègre le composant d’inscription de compte dans votre application, et vos comptes connectés interagissent avec le composant intégré sans quitter votre application. L’inscription intégrée utilise l’API Accounts pour lire les exigences et générer un formulaire d’inscription hébergée avec une validation robuste des données. Elle est localisée pour tous les pays dans lesquels Stripe est disponible.

Utilisation de l’inscription personnalisée

Si vous préférez créer un processus d’inscription personnalisé pour vos utilisateurs, utilisez POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}} et POST /v1/accounts/{{CONNECTED_ACCOUNT_ID}}/persons/{{PERSON_ID}} pour mettre à jour les objets Account et Person correspondants avec les informations requises.

Vous devez également confirmer que le propriétaire du compte connecté a lu et accepté l’accord relatif aux Financial Accounts pour les plateformes. Pour en savoir plus sur le respect des conditions d’inscription des utilisateurs, consultez la page Traitement de la vérification avec l’API.

Conditions requises

Les champs du tableau suivant sont obligatoires pour Financial Accounts des utilisateurs de plateformes.

Finalisation

Le processus d’inscription du compte connecté s’achève lorsque vous recevez un webhook account.updated confirmant les champs suivants sur votre compte connecté :

Si le partenaire bancaire de votre plateforme est Evolve Bank & Trust, le délai d’attente pour l’ouverture d’un compte est de moins de cinq minutes.

Mises à jour apportées aux exigences

Afin de s’adapter à l’évolution des réglementations financières, Stripe doit occasionnellement mettre à jour ses exigences en matière de collecte d’informations pour les plateformes. Le tableau requirements.eventually_due de l’objet Account capture les nouvelles informations ainsi exigées. En savoir plus sur le hachage exigences.