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.

Copier la page

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

    Remarque

    Après avoir créé le nouveau compte, vérifiez que celui-ci s’affiche bien 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.

Remarque

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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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 Account. Vous pouvez préremplir n’importe quelle information de compte, y compris des informations personnelles et professionnelles, des informations de 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_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -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.

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 vous ne pouvez utiliser le protocole HTTPS qu’en mode production. Veillez à modifier les URL de test avec 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 l’entrée de votre client dans le flux et sa sortie se sont déroulées correctement.

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 ses données de compte et vérifier le paramètre charges_enabled. Si l’inscription du compte n’a pas été finalisée, affichez des invites pour encourager l’utilisateur à poursuivre son inscription. Il pourra achever l’activation de son compte grâce à un nouveau lien de compte (généré par votre intégration). Vous pourrez vérifier l’état du paramètre details_submitted sur son compte pour voir s’il a complété son inscription.

Voir aussi

Cette page vous a-t-elle été utile ?
OuiNon
Besoin d'aide ? Contactez le service Support.
Rejoignez notre programme d'accès anticipé.
Consultez notre log des modifications.
Des questions ? Contactez l'équipe commerciale.
LLM ? Lire llms.txt.
Propulsé par Markdoc