Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous

Utiliser Connect avec des comptes connectés Standard

Utilisez les comptes connectés Standard pour commencer à utiliser Connect immédiatement, et laissez Stripe gérer la majeure partie de l'expérience des comptes connectés.

Un compte connecté standard est un compte Stripe classique, dont la relation à Stripe est directe, qui peut se connecter au Dashboard, et peut traiter ses paiements par 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.

Capture d'écran du formulaire d'inscription Connect

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

  1. 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.

  2. 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 produire le lien vers le compte. Vous devez passer le paramètre suivant :

    • type = standard

    Note

    Après avoir créé le nouveau compte, vérifiez que le compte s’affiche dans le Dashboard.

  3. Appelez l’API Account Links pour créer un lien avec lequel le compte pourra s’inscrire.

  4. Dans le flux d’inscription de votre plateforme, redirigez votre utilisateur vers l’url renvoyée par l’API Account Links.

  5. Traitez les états de compte supplémentaires en redirigeant votre compte vers le flux Connect Onboarding, si nécessaire.

  6. Facultatif : vous pouvez ajouter des procédures supplémentaires au flux Connect Onboarding, par exemple pour Tax ou Climate, via les options Connect Onboarding disponibles dans le Dashboard.

Créez un compte Standard et pré-remplissez les informations

Use the Create Account API to create a connected account with type set to standard. You can prefill any information, but at a minimum, you must specify the type. The country of the account defaults to the same country as your platform, and the account confirms the selection during onboarding. If you know what capabilities the account needs, you can request them when you create it.

Note

Cet exemple n’inclut qu’une partie des champs qu’il est possible de définir à la création d’un compte. Pour obtenir la liste complète des champs disponibles, tels que address et website_url, consultez la documentation relative à l’API Create Account.

Command Line
curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d type=standard

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
Command Line
curl https://api.stripe.com/v1/account_links \
  -u "
sk_test_4eC39HqLyjWDarjtT1zdp7dc
:" \
  -d account=
{{CONNECTED_ACCOUNT_ID}}
 \
  --data-urlencode refresh_url="https://example.com/reauth" \
  --data-urlencode return_url="https://example.com/return" \
  -d 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 :

  • Écoute des webhooks account.updated
  • Appeler l’API Accounts et inspecter l’objet renvoyé

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 permettant à votre serveur d’appeler à nouveau Account Links avec les mêmes paramètres, et de rediriger l’utilisateur vers le flux Connect Onboarding pour 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é 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.

Voir aussi

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service d'assistance.
Rejoignez notre programme d'accès anticipé.
Consultez notre journal des modifications des produits.
Des questions ? Contactez l'équipe commerciale.
Propulsé par Markdoc
Sur cette page
Démarrer
Comment utiliser le flux d’inscription Connect Onboarding pour les comptes Standard
Créez un compte Standard et pré-remplissez les informations
Créez un lien de compte
Redirigez votre utilisateur vers l'URL du lien de compte
Gérer le retour de l'utilisateur à votre plateforme
Gérer les utilisateurs dont l'inscription n'est pas terminée
Voir aussi
Produits utilisés
Connect