Utilisation de Connect avec des comptes Express
Démo Express
Pour visualiser le flux complet de l’inscription Express en action, testez l’exemple d’intégration Express de bout en bout avant de commencer à construire la vôtre. Cette démo présente l’expérience d’inscription d’un utilisateur et la gestion des comptes pour Rocket Rides, une place de marché à la demande.
Vous pouvez trouver le code source complet de la démo sur GitHub.
Avant de commencer
Pour créer des comptes Express, vous devez remplir toutes ces conditions :
- Version API minimum : Express nécessite la version API du 25/05/2017 ou ultérieure. Les fonctionnalités d’Express nécessitent la version API du 19/02/2019 ou ultérieure.
- Plateforme dans un pays pris en charge : les plateformes établies en Allemagne, Australie, Autriche, Belgique, Brésil, Bulgarie, Canada, Chypre, Croatie, Danemark, Espagne, Estonie, États-Unis, Finlande, France, Grèce, Hong Kong, Hongrie, Irlande, Italie, Japon, Lettonie, Lituanie, Luxembourg, Malte, Mexique, Norvège, Nouvelle-Zélande, Pays-Bas, Pologne, Portugal, République tchèque, Roumanie, Royaume-Uni, Singapour, Slovaquie, Slovénie, Suède, Suisse ou Thaïlande peuvent créer des comptes Express pour la plupart des pays pris en charge par Stripe. Pour en savoir plus sur les restrictions applicables à chaque pays ou recevoir une notification lorsque les comptes Express seront disponibles dans votre pays, contactez-nous.
- Pays qui où le libre-service n’est pas pris en charge : en raison de restrictions applicables à l’utilisation de Connect aux Émirats arabes unis et en Thaïlande, les utilisateurs de plateforme dans ces pays ne peuvent pas créer de comptes Express Connect en libre-service. Pour commencer l’inscription de comptes Express dans ces pays, contactez-nous.
- Plateformes des Émirats arabes unis (EAU) : les plateformes établies aux EAU peuvent utiliser des comptes Express établis aux EAU uniquement avec les types de paiement suivants : destination_charges (paiements indirects) et paiements et transferts distincts. Les paiements indirects utilisant l’attribut on_behalf_of ne sont pas encore pris en charge pour les plateformes établies aux EAU.
- Contrôle de la fraude : votre plateforme étant responsable des pertes subies par les comptes Express, vous devez examiner attentivement tous les comptes qui s’inscrivent via votre plateforme afin de détecter d’éventuelles fraudes. Pour en savoir plus, consultez notre guide des bonnes pratiques de la gestion des risques.
- Profil de plateforme : Vous devez définir le profil de votre plateforme.
Inscrire des comptes Express basés dans un autre pays que celui de votre plateforme
Vous pouvez activer l’inscription des utilisateurs par pays dans la section Paramètres Connect de votre Dashboard.
Le flux d’inscription au compte Express est actuellement localisé en anglais, français, espagnol, bulgare, chinois simplifié, chinois traditionnel, tchèque, danois, néerlandais, allemand, estonien, finnois, grec, hongrois, indonésien, italien, japonais, letton, lituanien, norvégien, polonais, portugais, roumain, slovaque, slovène, suédois et thaï.
Gardez à l’esprit les points suivants pour l’inscription des utilisateurs à l’international :
- Commerce international : Votre plateforme a la responsabilité de comprendre les implications de la conduite des affaires au niveau international, telles que les déclarations fiscales et les rapports financiers.
- Tunnels de paiements : Assurez-vous de revoir vos options pour créer des paiements en fonction des pays dans lesquels vous avez l’intention d’exercer vos activités.
- Type de contrat de service : Votre plateforme peut créer des comptes connectés dans le cadre du contrat de service du bénéficiaire afin d’activer les transferts internationaux. Ces comptes auront un accès limité aux fonctionnalités.
Configurer l'expérience d'inscription des utilisateurs
Avant d’inscrire votre premier compte, accédez à la page des paramètres Connect pour personnaliser l’aspect visuel du formulaire avec le nom, la couleur et l’icône de votre marque. Connect Onboarding exige ces informations.
Créer un compte Express et pré-remplir les informations
Utilisez l’API Create Account pour créer un compte connecté dont le type
est défini sur express
. 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 connaissez le pays et les fonctionnalités de votre compte connecté, vous pouvez fournir ces informations au moment de la création du compte. Le flux d’inscription Connect Onboarding recueille 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 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 inscrivez un compte qui ne dispose pas de son propre site Web et que votre plateforme lui fournit une URL personnelle, préremplissez sa business_profile.url
. 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, préremplissez les informations du compte à l’aide des données de test.
Si vous omettez capabilities
, Connect Onboarding utilise les paramètres de la section Paramètres de configuration du Dashboard Stripe pour demander automatiquement des fonctionnalités en fonction du pays du compte.
Créer un lien de compte
Créez un lien de compte 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
Rediriger votre compte vers l'URL de lien de compte
Un lien de compte contient une url
. Redirigez le compte vers ce lien pour le faire passer par 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. Authentifiez le compte dans votre application avant de le rediriger vers cette URL.
Avant de créer le premier lien de compte pour un compte Express, préremplissez toutes les informations Know Your Client (KYC). Une fois que vous avez créé un lien de compte pour un compte Express, vous ne pouvez plus consulter ni mettre à jour ses informations KYC.
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
Le flux d’inscription Connect 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 les implémentiez correctement 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 les tests avec votre localhost), mais le mode production n’accepte que le protocole HTTPS. Veillez à remplacer les URL de test par des URL HTTPS avant le lancement en mode production.
return_url
Stripe émet une redirection vers cette URL lorsque l’utilisateur a achevé le processus d’inscription de Connect Onboarding. Cela ne veut pas dire que toutes les informations ont été recueillies ou qu’il ne reste pas des conditions à remplir pour le compte. Cela signifie seulement que le passage par le tunnel a fonctionné correctement.
Aucun état n’est transmis par cette URL. Une fois qu’un utilisateur est redirigé vers votre return_url
, vérifiez l’état du paramètre details_submitted
(détails soumis) sur son compte en suivant l’une des deux méthodes suivantes :
- Écouter des événements
account.updated
à l’aide d’un webhook Connect. - Récupérer le compte à l’aide de l’API.
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à visité l’URL (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
devrait déclencher une méthode permettant à votre serveur de rappeler Account Links avec les même paramètres, et de rediriger l’utilisateur vers le flux Connect Onboarding pour créer une expérience transparente.
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é le processus d’inscription. Récupérez le compte de l’utilisateur et recherchez le paramètre charges_enabled
. Si l’inscription du compte n’est pas terminée, fournissez des invites à l’interface utilisateur pour permettre à l’utilisateur de poursuivre l’inscription ultérieurement. L’utilisateur peut 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 le compte de l’utilisateur pour savoir si le processus d’inscription est terminé.