Utilisation de Connect avec des comptes Standard
Un compte Standard est un compte Stripe classique pour lequel le titulaire du compte (c’est-à-dire l’utilisateur de votre plateforme) est lié à Stripe, peut se connecter au Dashboard et peut traiter les paiements lui-même.
L’exemple d’intégration de Stripe, Kavholm, vous montre comment utiliser le flux d’inscription Connect Onboarding pour créer une expérience d’inscription fluide pour vos utilisateurs.
Démarrer
Si vous débutez avec Connect, commencez par consulter le guide qui explique comment utiliser des comptes Standard pour permettre à d’autres entreprise d’accepter des paiements directement.
Comment utiliser le flux d’inscription Connect Onboarding pour les comptes Standard
Accédez à la page des paramètres Connect pour personnaliser l’aspect visuel du formulaire avec le nom, la couleur et le logo de votre marque. Connect Onboarding requiert ces informations.
Utilisez l’API
/v1/accounts
pour créer un nouveau compte et obtenir l’identifiant du compte. Vous pouvez pré-remplir ces informations dans l’objet du compte pour l’utilisateur avant de générer le lien vers le compte. Vous devez transmettre le paramètre suivant :type
=standard
Note
Après avoir créé le nouveau compte, vérifiez que celui-ci s’affiche bien dans le Dashboard.
Appelez l’API Account Links pour créer un lien avec lequel le compte pourra s’inscrire.
Dans le flux d’inscription des utilisateurs pour votre propre plateforme, redirigez votre utilisateur vers l’
url
renvoyée par Account Links.Traitez les états de compte supplémentaires en redirigeant votre compte vers le flux Connect Onboarding, si nécessaire.
Facultatif : vous pouvez ajouter des procédures supplémentaires au flux Connect Onboarding, par exemple pour Tax ou Climate, via la configuration du produit de la platforme, dans le Dashboard.
Créez un compte Standard et pré-remplissez les informations
Utilisez l’API Create Account pour créer un compte connecté dont le type
est défini sur standard
. Vous pouvez préremplir n’importe quelle information, mais vous devez au minimum spécifier le type
. Par défaut, le pays du compte est le même que celui de votre plateforme. Le compte peut confirmer ou modifier cette sélection lors de l’inscription.
Note
Cet exemple inclut seulement certains des champs qu’il est possible définir à la création d’un compte. Pour obtenir la liste complète des champs disponibles, comme address
et website_url
, consultez la documentation sur l’API Create Account.
Si vous avez déjà collecté des informations pour vos comptes connectés, vous pouvez préremplir ces informations dans l’objet de compte. Vous pouvez pré-remplir n’importe quelle information de compte, y compris des informations personnelles et professionnelles, des informations relatives à un compte externe, etc.
Connect Onboarding ne demande pas les informations préremplies. Cependant, il demande au titulaire du compte de confirmer les informations préremplies avant d’accepter le contrat d’utilisation du service Connect.
Lorsque vous testez votre intégration, préremplissez les informations du compte à l’aide des données de test.
Créez un lien de compte
Vous pouvez créer un lien de compte en appelant l’API Account Links avec les paramètres suivants :
account
(Utilisez l’ID de compte renvoyé par l’API à l’étape précédente)refresh_url
return_url
type
=account_onboarding
Redirigez votre utilisateur vers l'URL du lien de compte
La réponse à votre requête à votre API Account Links contient une valeur pour l’url
de la clé. Redirigez l’utilisateur vers ce lien pour l’introduire dans le flux. Vous ne pouvez utiliser qu’une seule fois les URL des liens de compte, car elles donnent accès aux informations personnelles du titulaire du compte. Authentifiez l’utilisateur dans votre application avant de le rediriger vers cette URL. Après avoir créé un lien de compte pour un compte Standard, vous n’aurez plus accès aux informations Know Your Customer (KYC), que ce soit en lecture ou en écriture. Préremplissez toutes les informations KYC avant de créer le premier lien de comte.
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
pour gérer tous les cas de redirection des utilisateurs vers votre plateforme. Il est important que vous implémentiez correctement ces URL afin de fournir la meilleure expérience à vos utilisateurs.
Note
Vous pouvez utiliser le protocole HTTP pour vos return_url
et refresh_url
lorsque vous êtes en mode test (par exemple, pour vos tests avec votre localhost), mais seul le protocole HTTPS s’applique en mode production. Veillez à remplacer vos URL de test par des URL HTTPS avant le lancement en mode production.
return_url
Stripe déclenche une redirection vers cette URL une fois que l’utilisateur a terminé son inscription Connect Onboarding. Ceci ne veut pas dire que toutes les informations ont été recueillies ni qu’il ne reste pas des conditions à remplir pour le compte, mais simplement que votre client est entré dans le flux et en est sorti sans que des soucis particuliers se posent.
Aucun état n’est transmis par cette URL. Une fois que l’utilisateur est redirigé vers votre return_url
, vérifiez l’état du paramètre details_submitted
sur son compte de l’une des manières suivantes :
refresh_url
Votre utilisateur est redirigé vers l’URL refresh_url
dans les cas suivants :
- Le lien a expiré (quelques minutes après la création du lien)
- L’utilisateur a déjà utilisé le lien (il a actualisé la page ou cliqué sur le bouton Précédent ou Suivant du navigateur)
- Votre plateforme ne peut plus accéder au compte
- Le compte a été rejeté
Votre refresh_url
déclenche une méthode sur votre serveur pour rappeler les Account Links avec les mêmes paramètres, et redirige l’utilisateur vers le flux Connect Onboarding afin de créer une expérience fluide.
Gérer les utilisateurs dont l'inscription n'est pas terminée
Un utilisateur qui est redirigé vers votre return_url
peut ne pas avoir terminé son inscription. Utilisez l’endpoint /v1/accounts
pour récupérer le compte de l’utilisateur et vérifier le paramètre charges_enabled
. Si l’inscription du compte n’est pas terminée, affichez des invites pour permettre à l’utilisateur de poursuivre son inscription. L’utilisateur pourra achever l’activation de son compte grâce à un nouveau lien de compte (généré par votre intégration). Vous pouvez vérifier l’état du paramètre details_submitted
sur son compte pour voir s’il a achevé son inscription.