Inscription intégrée
L’inscription intégrée est une interface utilisateur hautement personnalisable avec un marquage Stripe limité. Votre plateforme intègre le composant d’inscription des comptes dans votre application, et vos comptes connectés interagissent avec le composant intégré sans jamais quitter votre application. L’inscription intégrée utilise l’API Accounts pour lire les exigences et générer un formulaire d’inscription avec une validation robuste des données. Elle est localisée pour tous les pays pris en charge par Stripe. De plus, l’inscription intégrée gère :
- Types d’entreprises
- Configurations des représentants de l’entreprise
- Chargement du document de vérification
- Identifier la vérification et les états
- Comptes bancaires internationaux
- États d’erreur
Créer un compte et pré-remplir les informationsCôté serveur
Créez un compte connecté en spécifiant le type de compte.
Si vous connaissez le pays de votre compte connecté, vous pouvez fournir ces informations au moment de la création du compte. S’il n’est pas fourni, le pays est par défaut le même que celui de votre plateforme.
Si vous avez besoin de demander des fonctionnalités pour votre compte connecté, vous pouvez fournir ces informations lorsque vous créez le compte. Les interfaces utilisateur d’inscription de Stripe recueillent ensuite les conditions requises pour ces fonctionnalités. Pour réduire l’effort d’inscription, demandez uniquement les fonctionnalités dont vous avez besoin. Si vous omettez des fonctionnalités et que votre compte connecté a accès au Dashboard Express, l’inscription hébergée par Stripe utilise les paramètres de configuration pour demander automatiquement des fonctionnalités en fonction du pays du compte.
Si vous disposez d’informations sur le titulaire du compte (comme son nom, son adresse, etc.), vous pouvez les fournir de manière proactive lorsque vous créez ou mettez à jour le compte. L’inscription hébergée par Stripe demande au titulaire du compte de confirmer les informations préremplies avant d’accepter le contrat de service Connect. Le fait de fournir plus d’informations via l’API permet de réduire le nombre d’invites et d’améliorer le flux d’inscription de votre compte connecté.
En outre, si vous inscrivez un compte qui ne dispose pas de son propre site Web et que votre plateforme lui fournit une URL, préremplissez la business_profile.url du compte. Si le compte n’a pas d’URL, vous pouvez préremplir sa business_profile.product_description à la place.
Lorsque vous testez votre intégration, utilisez des données de test pour simuler différents résultats, notamment la vérification d’identité, la vérification des informations de l’entreprise, les échecs de virement, etc.
Déterminer les informations à collecter
En tant que plateforme, vous devez décider entre collecter toutes les informations requises auprès de vos comptes connectés au début du processus (inscription complète), ou les recueillir progressivement (inscription progressive). L’inscription complète collecte les exigences eventually_due
pour le compte, tandis que l’inscription progressive collecte uniquement les exigences currently_due
.
Inscription complète | Inscription progressive des utilisateurs | |
---|---|---|
Avantages |
|
|
Inconvénients |
|
|
Pour déterminer si vous devez utiliser l’inscription complète ou progressive, consultez les informations requises selon les pays de vos comptes connectés pour comprendre quelles seront les exigences attendues à l’avenir. Stripe s’efforce de minimiser son impact sur les comptes connectés, cependant, les exigences sont susceptibles d’évoluer.
Dans le cas des comptes connectés pour lesquels vous êtes responsable de la collecte des exigences, vous pouvez personnaliser le comportement des exigences futures à l’aide de l’attribut collectionOptions
lors de l’intégration du composant d’inscription des comptes.
Personnaliser les politiques présentées à vos utilisateurs
Connected accounts see Stripe’s service agreement and Privacy Policy during embedded onboarding. Connected account users who haven’t accepted Stripe’s services agreement must accept it on the final onboarding screen. Embedded onboarding also has a footer with links to Stripe’s service agreement and Privacy Policy.
For connected accounts where the platform is responsible for requirement collection, you have additional options to customize the onboarding flow, as outlined below.
Handle service agreement acceptance on your own
If you’re a platform onboarding connected accounts where you’re responsible for requirement collection, you can collect Terms of Service acceptance using your own process instead of using the embedded account onboarding component. If using your own process, the final onboarding screen only asks your connected accounts to confirm the information they entered, and you must secure their acceptance of Stripe’s service agreement.
Embedded onboarding still has links to the terms of service (for example, in the footer) that you can replace by linking to your own agreements and privacy policy.
Link to your agreements and privacy policy
Connected accounts see the Stripe service agreement and Privacy Policy throughout embedded onboarding. For the connected accounts where you’re responsible for requirement collection, you can replace the links with your own agreements and policy. Follow the instructions to incorporate the Stripe services agreement and link to the Stripe Privacy Policy.
Intégrer le composant d'inscription de compteCôté serveurCôté client
Créez une session de compte en spécifiant l’ID du compte connecté et account_onboarding
comme composant à activer.
Create an Account Session
When creating an Account Session, enable account onboarding by specifying account_onboarding
in the components
parameter.
Après avoir créé la session de compte et initialisé ConnectJS, vous pouvez afficher le composant d’inscription de compte dans le front-end :
Traiter les nouvelles exigences qui arrivent à échéanceCôté serveur
Configurez votre intégration pour écouter les changements des exigences du compte. Vous pouvez tester la gestion des nouvelles exigences (et la désactivation des paiements et virements qui peut en résulter) en utilisant les cartes dotées de déclencheurs pour le mode test. Stripe vous informe lorsque les mises à jour des exigences à venir affectent vos comptes connectés.
Vous pouvez collecter des informations de manière proactive pour répondre à des exigences futures. En fonction des besoins de votre application en matière de vérification, renvoyez le compte connecté vers le flux d’inscription si nécessaire pour satisfaire aux exigences currently_due
ou eventually_due
. Vous pouvez vous en servir comme d’un signal pour savoir quand renvoyer votre compte connecté vers le flux.
Vous n’avez pas à vous soucier des conditions requises : le fait de renvoyer le compte connecté dans le flux d’inscription permet de collecter les bonnes informations. Par exemple, si votre compte connecté commet une erreur de saisie et que ses informations ne peuvent être vérifiées, il peut être invité à fournir une pièce d’identité (par exemple, un permis de conduire pour les États-Unis). Dès l’instant où vous renvoyez cet utilisateur vers le flux d’inscription, il est invité à charger le document approprié à des fins de vérification.
Gérer les erreurs de vérification
Écoutez l’événement account.updated. Si le compte contient des champs currently_due
à l’arrivée de la date current_deadline
, la fonctionnalité correspondante est désactivée et ces champs sont ajoutés à past_due
.
Laissez vos comptes remplir leurs exigences de vérification en les dirigeant vers le composant d’inscription de compte.