Migrez vos flux d’onboarding et de mise à jour des exigences vers l’onboarding hébergé par Stripe ou intégré

Pour maintenir un flux d’onboarding basé sur une API pour vos comptes connectés, vous devez mettre à jour votre intégration chaque fois que les exigences changent ou lorsque vous souhaitez intégrer des comptes dans un nouveau pays. Stripe vous recommande d’éviter ces efforts en migrant votre flux vers une intégration hébergée ou intégrée par Stripe. Ces deux types d’intégration permettent de déterminer automatiquement les exigences à collecter et sont localisés pour tous les pays pris en charge par Stripe.

• Onboarding hébergé par Stripe : cette méthode nécessite le moins d’efforts techniques. Cependant, elle offre très peu de possibilités de personnalisation et ne permet pas d’empêcher un utilisateur du compte de modifier les informations que vous avez préremplies.
• Onboarding intégré : cette méthode nécessite davantage d’efforts d’ingénierie, mais vous permet de créer une interface d’onboarding plus personnalisée. Vous pouvez empêcher les utilisateurs du compte de modifier les informations que vous préremplissez.
• Types d’onboarding combinés : cette méthode nécessite différents niveaux d’effort technique, en fonction de votre intégration. Par exemple, votre flux basé sur une API collecte certaines exigences, les composants intégrés gèrent toutes les autres exigences et vous fournissez un formulaire hébergé par Stripe pour que les utilisateurs du compte puissent mettre à jour volontairement leurs informations de compte.

Pour en savoir plus sur les différences entre les types d’onboarding, consultez la section Choisissez votre configuration d’onboarding.

Inscription hébergée par Stripe

Pour utiliser l’onboarding hébergé par Stripe, vous fournissez à chaque compte connecté un lien de compte à usage unique et spécifique au compte qui ouvre un formulaire permettant de collecter des informations. Vous pouvez générer un lien de compte pour collecter uniquement les informations manquantes ou pour permettre à un utilisateur du compte de mettre à jour toutes les informations accessibles du compte.

La migration de votre flux d’onboarding de compte connecté vers l’onboarding hébergé par Stripe comprend les étapes suivantes :

1. Dans votre Dashboard de la plateforme, ouvrez votre paramètres de l’interface d’onboarding Connect et cliquez sur Personnaliser pour définir l’image de marque de votre formulaire onboarding.
2. Sélectionnez l’onglet Expérience d’onboarding, puis entrez le nom de l’entreprise et sélectionnez une icône, un logo et des couleurs. Vous pouvez également sélectionner Copier l’image de marque de la plateforme pour appliquer les paramètres de l’image de marque de votre plateforme au formulaire.
3. Lorsque votre application redirige les utilisateurs de comptes connectés vers votre flux d’onboarding personnalisé, mettez-le à jour afin de générer un lien de compte et de les rediriger vers celui-ci. Lorsque vous générez un lien de compte, vous pouvez configurer des options telles que les suivantes :
   • URL vers laquelle diriger les compte utilisateur lorsqu’ils terminent le flux d’onboarding
   • URL vers laquelle rediriger l’utilisateur du compte si le lien du compte est expiré ou invalide.
   • S’il convient de recouvrer les créances éventuellement exigibles
   • S’il faut collecter les besoins futurs
4. Remplacez à la fois le flux d’onboarding initial et tout flux qui collecte les exigences mises à jour.
5. Déprécier les flux basés sur l’API dont vous n’avez plus besoin.

Chaque fois qu’un utilisateur de compte accède à l’onboarding hébergé par Stripe, celle-ci reflète les exigences actualisées. Vous n’avez pas besoin de mettre à jour vos liens de compte lorsque les exigences changent.

Pour obtenir des instructions détaillées, y compris sur la configuration des liens de compte, consultez la documentation relative à l’ onboarding hébergé par Stripe.

Inscription intégrée

L’onboarding intégré nécessite plus d’efforts d’ingénierie que l’onboarding hébergé par Stripe, mais permet beaucoup plus de personnalisation, par exemple :

• Contrôlez entièrement la conception des pages où vous intégrez des composants
• Collecter uniquement une liste spécifique d’exigences
• Exclure une liste spécifiée d’exigences du recouvrement
• Informez automatiquement les comptes connectés des exigences non encore satisfaites

Vous pouvez utiliser les composants intégrés Connect suivants pour intégrer les comptes connectés et collecter les exigences :

• Onboarding du compte : permet à un utilisateur du compte de fournir uniquement les exigences en cours. Il inclut toujours les exigences actuellement échues, et vous pouvez le configurer pour qu’il inclue également les exigences éventuellement échues ou futures.
• Gestion de compte : permet à un utilisateur de compte de mettre à jour divers types d’informations relatives au compte, y compris, mais sans s’y limiter, les exigences en suspens. Cependant, un compte connecté ne peut pas utiliser ce composant pour répondre aux vérifications des risques.
• Bannière de notification : permet à un utilisateur de compte de fournir uniquement les exigences en suspens. Le compte connecté doit avoir déjà terminé l’intégration initiale, vous ne pouvez donc utiliser ce composant que pour les exigences mises à jour ou les vérifications des risques. Il ne s’affiche que si le compte connecté a des exigences en suspens, et vous ne pouvez pas le configurer pour inclure ou exclure des exigences spécifiques.

Pour l’onboarding initial des comptes connectés, utilisez le composant d’onboarding Account.

Migration complète avec recouvrement simple

Pour migrer l’ensemble de votre flux d’intégration vers l’intégration intégrée, sans restreindre la possibilité pour les utilisateurs du compte de modifier les informations préremplies, procédez comme suit :

1. Concevez la page qui contiendra le composant intégré. Vous pouvez utiliser une page de votre flux d’onboarding existant comme point de départ.
2. Personnaliser l’apparence du composant intégré.
3. Lorsque votre application redirige les utilisateurs du compte connecté vers votre flux personnalisé pour l’onboarding initial, mettez-le à jour afin de créer une session de compte et d’installer le composant d’onboarding de compte. Lorsque vous créez une session de compte, vous pouvez configurer des options telles que les suivantes :
   • S’il convient de recouvrer les créances éventuellement exigibles
   • S’il faut collecter les besoins futurs
   • S’il s’agit d’un lien vers des conditions d’utilisation du service personnalisées ou une politique de confidentialité personnalisée.
   • S’il faut collecter des informations de compte externe.
4. Remplacez chaque flux de votre application qui collecte les exigences mises à jour par l’un des composants intégrés pertinents. L’utilisation du composant de gestion de compte ou de bannière de notification est similaire à l’utilisation du composant d’onboarding de compte.
5. Déprécier les flux basés sur l’API dont vous n’avez plus besoin.

Chaque fois qu’un composant est rendu, il reflète les exigences les plus récentes. Vous n’avez pas besoin de mettre à jour les composants lorsque les exigences changent.

Pour obtenir des instructions détaillées, y compris sur la configuration des sessions de compte, consultez la documentation relative à l’onboarding intégré.

Migration partielle ou migration avec recouvrement personnalisé

Vous pouvez migrer partiellement vos flux d’onboarding et de rectification ou mettre en œuvre une collecte personnalisée des exigences en configurant les composants d’intégration et de gestion des comptes afin de ne collecter que certaines informations. Par exemple :

• Ne collectez qu’une liste spécifiée d’exigences : utilisez des composants intégrés avec l’option de recouvrement only, pour ne collecter que certaines exigences complexes ou détaillées, et votre flux d’onboarding API existant pour collecter toutes les autres exigences. Par exemple, si vous commencez à intégrer des comptes dans une région avec des exigences uniques en matière de documentation de preuve de vie, vous pouvez ajouter un composant intégré pour collecter uniquement ces exigences.
• Collectez toutes les exigences à l’exception d’une liste spécifiée : préremplissez certaines informations lorsque vous créez un compte et utilisez des composants intégrés avec l’option de recouvrement exclude pour empêcher les utilisateurs du compte de modifier ces informations.
• Report de la collecte des comptes externes : reportez la collecte des comptes externes jusqu’après la première transaction d’un compte connecté en désactivant la collecte des comptes externes lors de l’onboarding initial. Après la première transaction d’un compte, présentez le composant d’onboarding du compte avec la collecte des comptes externes activée et en utilisant la seule option de collecte only pour collecter uniquement le compte externe.

La migration de votre flux onboarding vers l’onboarding intégré avec collecte personnalisée des exigences comprend les étapes suivantes :

1. Concevez la page qui contiendra le composant intégré. Vous pouvez utiliser votre page d’onboarding existante comme point de départ.
2. Personnaliser l’apparence du composant intégré.
3. Lorsque votre application redirige les utilisateurs du compte connecté vers votre flux personnalisé pour l’onboarding initial, mettez-le à jour afin de créer une session de compte et d’installer le composant d’onboarding de compte. Lorsque vous créez une session de compte, vous pouvez configurer des options telles que les suivantes :
   • S’il faut collecter uniquement une liste spécifiée d’exigences
   • S’il faut exclure une liste spécifiée de composants de la collecte, quel que soit leur état
   • S’il convient de recouvrer les créances éventuellement exigibles
   • S’il faut collecter les besoins futurs
   • S’il faut renvoyer vers des conditions d’utilisation du service personnalisées ou une politique de confidentialité personnalisée
   • S’il faut collecter des informations sur les comptes externes
4. Remplacez chaque flux de votre application qui collecte les exigences mises à jour par l’un des composants intégrés pertinents. L’utilisation du composant de gestion de compte ou de bannière de notification est similaire à l’utilisation du composant d’onboarding de compte, bien que vous ne puissiez pas contrôler les exigences collectées par la bannière de notification. Lorsque les exigences changent, vous n’avez pas besoin de spécifier les informations mises à jour à collecter. Il vous suffit de présenter l’un des composants à vos comptes connectés.
5. Déprécier les flux basés sur l’API dont vous n’avez plus besoin.

Chaque fois qu’un composant est rendu, il reflète les exigences les plus récentes. Vous n’avez pas besoin de mettre à jour les composants lorsque les exigences changent.

Pour obtenir des instructions détaillées, notamment sur la configuration des sessions de compte et la restriction de la collecte des exigences, consultez la documentation relative à l’onboarding intégré.

Types d’onboarding combinés

Pour mettre en œuvre une combinaison de types d’onboarding, suivez les instructions fournies dans les sections l’onboarding hébergé par Stripe et l’onboarding partiellement intégré pour les exigences que vous souhaitez traiter avec chacun de ces types de onboarding. Ensuite, mettez à jour votre flux basé sur l’API afin de ne traiter que les exigences que vous ne migrez pas. N’oubliez pas que vous ne pouvez configurer l’onboarding hébergé par Stripe que pour permettre la modification de toutes les exigences ou uniquement des exigences en suspens. Pour toute autre configuration, vous devez utiliser l’onboarding intégré ou basé sur l’API.