Inscrire vos comptes connectés

Inscrivez vos comptes connectés sur votre marketplace.

Après toi créer et préremplir un compte connecté, créez unlien de compte et l’envoyer à l’utilisateur pour qu’ils puissent terminer le inscription des utilisateurs processus. Un lien de compte est une URL à usage unique que vous envoyez à un compte connecté et qui lui accorde l’autorisation d’accéder au flux d’intégration Connect Onboarding.

Vous pouvez également créer un flux d’inscription des utilisateurs personnalisé à l’aide decomposants intégrés ou l’API. Pour simplifier la conformité et la maintenance, utilisez les liens de comptes ou créez votre propre flux d’inscription avec des composants intégrés. Ce guide utilise des liens de compte.

Le flux d’intégration Connect Onboarding ne demande pas à votre compte connecté les informations que vous avez pré-remplies. Cependant, il demande au compte connecté de confirmer les informations pré-remplies avant d’accepter le Contrat d’utilisation du service Connect.

Remarque

L’inscription hébergée par Stripe n’est prise en charge que dans les navigateurs Web. Vous ne pouvez pas l’utiliser dans des vues Web intégrées à des applications mobiles ou de bureau.

Créer un lien de compte

Paramètres	Valeur	Obligatoire	Description
Compte	L’identifiant du compte connecté	Oui	Définissez cette option sur l’ID du compte connecté pour lequel vous créez un lien de compte.
return_url	Une URL valide	Oui	URL vers laquelle rediriger l’utilisateur une fois qu’il a quitté ou terminé le flux d’inscription des utilisateurs.
refresh_url	Une URL valide	Oui	URL vers laquelle rediriger l’utilisateur si le lien de compte a expiré, a déjà été visité ou n’est pas valide. Utilisez cette URL pour générer un nouveau lien de compte avec les mêmes paramètres que ceux que vous avez utilisés pour créer le lien de compte d’origine.
type	`account_onboarding`	Oui	Fournit un formulaire pour collecter les nouvelles informations dont vous avez besoin.

Rediriger votre utilisateur vers une URL Account Link

La réponse à votre requête Liens de compte contient une valeur pour la clé url. Redirigez vers ce lien afin d’envoyer le compte connecté dans le processus d’inscription.

Les URL générées par l’API des liens de compte sont temporaires et utilisables une seule fois, car elles donnent accès aux informations personnelles de l’utilisateur du compte connecté. Authentifiez l’utilisateur dans votre formulaire d’inscription avant de le rediriger vers cette URL. Si vous souhaitezpréremplir des informations, vous devez le faire avant de générer le lien de compte. Une fois que vous avez créé le lien de compte, vous ne pouvez plus lire ni modifier les informations du compte connecté.

Conseil en matière de sécurité

N’envoyez pas d’URL de lien de compte par e-mail, SMS ou autre moyen de paiement en dehors de l’application de votre plateforme. Fournissez-les plutôt au titulaire du compte authentifié dans votre application.

Gérer le retour de l'utilisateur à votre plateforme

Connect onboarding vous demande de transmettre à la fois une return_url et une refresh_url afin de gérer tous les cas de redirection des utilisateurs vers votre plateforme. Il est important que vous les implémentiez correctement afin d’offrir à vos utilisateurs une expérience optimale.

Remarque

Vous pouvez fonctionner en HTTP pour vos return_url et refresh_url lorsque vous êtes dans un environnement de test (par exemple, pour tester avec localhost), mais notez que le mode production n’accepte que le protocole HTTPS. Veillez à modifier les URL de test avec des URL HTTPS avant le lancement en mode production.

Définir l’URL de retour

Stripe redirige le compte connecté vers cettereturn_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é collectées 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 paramètre d’état n’est transmis avec cette URL. Après la redirection du compte connecté vers le return_url, déterminez si le compte a terminé le processus d’inscription en procédant comme suit :

Récupération du compte et vérification du hachage requirements pour identifier les exigences en attente.
Écoutez l’événement account.updated envoyé à votre endpoint de webhook et mettez en cache l’état du compte dans votre formulaire d’inscription. Si le compte n’a pas terminé l’inscription, fournissez des invites dans votre formulaire d’inscription pour permettre à l’utilisateur de poursuivre l’inscription plus tard.

Définir l’URL d’actualisation

Stripe redirige votre utilisateur vers le refresh_url dans les cas suivants :

Le lien a expiré (quelques minutes se sont écoulées après la création du lien).
L’utilisateur a déjà utilisé l’URL (il a actualisé la page ou cliqué sur le bouton Précédent ou Suivant de son navigateur).
Votre plateforme n’est plus en mesure d’accéder au compte.
Le lien a été partagé dans une application tierce, comme un client de messagerie, qui tente d’accéder à l’URL pour afficher un aperçu. De nombreux clients visitent automatiquement les liens, ce qui entraîne leur expiration.
Le compte a été rejeté.

Configurez la méthode refresh_url pour qu’elle appelle une méthode sur votre serveur afin d’appeler Account Links à nouveau pour créer un nouveau Account Link avec les mêmes paramètres, puis rediriger le compte connecté vers la nouvelle URL de l’Account Link.

Gérer les utilisateurs dont l'inscription n'est pas terminée

Un utilisateur qui est redirigé vers votrereturn_url peut ne pas avoir terminé le processus d’inscription. Pour vérifier si un utilisateur a complété ce processus, récupérez le compte de l’utilisateur et vérifiez que details_submitted est défini sur true. Sidetails_submitted est défini sur false,le compte n’est pas complètement inscrit. Fournissez des invites dans votre application pour permettre à l’utilisateur de poursuivre l’inscription ultérieurement. L’utilisateur peut terminer l’activation de son compte via un nouveau lien de compte généré par votre intégration.

Étapes suivantes

Ensuite, activez les moyens de paiement que vous souhaitez prendre en charge.