Inscription des utilisateurs hébergée par Stripe
L’inscription hébergée par Stripe gère la collecte des informations sur l’entreprise et sur la vérification de l’identité des comptes connectés. Il s’agit d’un formulaire Web hébergé par Stripe qui s’adapte de manière dynamique en fonction des fonctionnalités, du pays et du type d’entreprise de chaque compte connecté. L’inscription hébergée par Stripe est la solution recommandée pour les entreprises qui souhaitent que Stripe s’occupe de l’inscription de leurs utilisateurs avec peu d’efforts de la part de la plateforme.
Le formulaire d’inscription hébergée pour l’exemple d’intégration de Stripe, Rocket Deliveries.
Personnaliser le formulaire d'inscriptionDashboard
Vous pouvez personnaliser l’aspect visuel du formulaire avec le nom, la couleur et l’icône de votre marque en accédant à la page des paramètres Connect dans le Dashboard. L’inscription hébergée par Stripe nécessite ces informations. Stripe recommande également de recueillir les informations bancaires de vos comptes connectés lors de leur inscription.
Créer un compte et pré-remplir les informationsCôté serveur
Créez un compte connecté avec les propriétés par défaut du contrôleur. Pour en savoir plus sur les propriétés des contrôleurs, consultez la section Concevoir une intégration. Vous pouvez également créer un compte connecté en spécifiant un 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.
Créer un lien de compteCôté serveur
Créez un lien de compte en utilisant l’ID du compte connecté et en incluant une URL de rafraîchissement ainsi qu’une URL de redirection. Stripe redirige le compte connecté vers l’URL de rafraîchissement si l’URL du lien de compte a déjà été visitée, a expiré ou n’est pas valide. Stripe redirige les comptes connectés vers l’URL de redirection lorsqu’ils ont terminé ou quitté le flux d’inscription. De plus, en fonction des informations que vous avez besoin de recueillir, vous pouvez transmettre soit currently_due
, soit eventually_due
pour le paramètre collection_options.fields
. Dans cet exemple, l’option eventually_due
est transmise pour utiliser l’inscription complète. L’option currently_due
est, quant à elle, transmise pour l’inscription progressive.
Rediriger votre compte connecté vers l’URL de lien de compte
Redirigez le compte connecté vers l’URL de lien de compte pour l’envoyer vers le flux d’inscription. Chaque URL de lien de compte ne peut être utilisée qu’une seule fois car elle donne accès aux informations personnelles du titulaire du compte. Identifiez le compte dans votre application avant de le rediriger vers cette URL.
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 les exigences de vérification en les dirigeant vers le formulaire de l’inscription hébergée par Stripe.
Gérer le retour du compte connecté vers votre plateforme
Le lien de compte nécessite une refresh_url
et une return_url
pour gérer tous les cas de redirection des comptes connectés vers votre plateforme. Il est important de les mettre en œuvre correctement afin de fournir le meilleur flux d’inscription pour vos comptes connectés.
Note
Vous pouvez utiliser le protocole HTTP pour vos refresh_url
et return_url
lorsque vous êtes en mode test (par exemple, pour tester localement). Cependant, en mode production, seul le protocole HTTPS est accepté. Veillez à remplacer toutes les URL de test par des URL avec le protocole HTTPS avant le lancement en mode production.
URL d’actualisation
Votre compte connecté est redirigé vers l’URL refresh_url
lorsque :
- Le lien a expiré (quelques minutes se sont écoulées depuis la création du lien).
- Le lien a déjà été visité (le compte connecté a actualisé la page ou a cliqué sur le bouton précédent ou suivant).
- Le lien a été partagé dans une application tierce, comme un client de messagerie, qui tente d’accéder à l’URL pour afficher en un aperçu. De nombreux clients visitent automatiquement les liens, ce qui entraîne leur expiration.
La refresh_url
doit appeler une méthode sur votre serveur pour créer un nouveau lien de compte avec les mêmes paramètres et rediriger le compte connecté vers la nouvelle URL de lien de compte.
URL de redirection
Stripe redirige le compte connecté vers cette URL lorsqu’il termine le flux d’inscription ou qu’il clique sur Enregistrer pour plus tard à n’importe quel moment du flux. Cela ne signifie pas que toutes les informations ont été recueillies ou que toutes les exigences du compte ont été satisfaites. Cela signifie uniquement que l’entrée et la sortie du flux ont fonctionné correctement.
Aucun état n’est transmis avec cette URL. Une fois qu’un compte connecté est redirigé vers return_url
, vérifiez si le compte a terminé son inscription. Récupérez le compte et vérifiez l’attribut exigences pour les exigences en attente. Vous pouvez également écouter l’événement account.updated
envoyé à votre endpoint de webhook et mettre en cache l’état du compte dans votre application. Si le compte n’a pas terminé son inscription, incluez des invites dans votre application pour lui permettre de continuer l’inscription plus tard.
Gestion des mises à jour initiées par le compte connecté
L’inscription hébergée par Stripe prend également en charge les mises à jour initiées par le compte connecté des informations qu’il a déjà fournies. Lorsque vous créez un lien de compte, vous pouvez définir le type
comme étant soit account_onboarding
, soit account_update
.
Inscription des comptes
Les liens de compte de ce type fournissent un formulaire permettant de saisir des exigences en attente. Utilisez-le lors de l’inscription d’un nouveau compte connecté ou lorsqu’un utilisateur existant a de nouvelles exigences (par exemple, lorsqu’un compte connecté a déjà fourni suffisamment d’informations mais que vous avez demandé une nouvelle fonctionnalité qui nécessite des informations supplémentaires). Dirigez l’utilisateur vers ce type de lien de compte pour recueillir les nouvelles informations dont vous avez besoin.
Mise à jour du compte
Les liens de compte de ce type sont activés pour les comptes desquels votre plateforme est responsable de la collecte des exigences. Les liens account_update
affichent les attributs déjà renseignés sur le compte et permettent à votre compte connecté de modifier les informations précédemment fournies (par exemple, pour mettre à jour leur adresse). Ajoutez une option dans votre application (par exemple, « Modifier mon profil » ou « Mettre à jour mes informations de vérification ») pour permettre aux comptes connectés d’effectuer eux-mêmes les mises à jour.
Navigateurs pris en charge
L’inscription hébergée par Stripe prend en charge :
- Les 20 dernières versions majeures de Chrome et Firefox
- Les deux dernières versions majeures de Safari et Edge
- Les deux dernières versions majeures de Safari mobile sur iOS
L’inscription hébergée par Stripe n’est pas prise en charge lorsqu’elle est intégrée dans les vues Web. Il est uniquement possible d’y accéder depuis un navigateur autonome.