Utiliser Connect avec des comptes connectés Express

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.

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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d type=express

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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d country=US \
  -d type=express \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  -d business_type=individual \
  --data-urlencode "business_profile[url]"="https://example.com"

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 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é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

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

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 connecté Express, préremplissez toutes les informations Know Your Client (KYC). Une fois que vous avez créé un lien de compte pour un compte connecté Express, vous ne pouvez plus consulter ni modifier ses informations KYC.

Connect Onboarding nécessite que vous transmettiez à la fois une URL return_url et une URL refresh_url pour gérer tous les cas de redirection des comptes connectés vers votre plateforme. Veillez à les implémenter correctement afin d’offrir la meilleure expérience possible à vos comptes connectés.

return_url

Stripe déclenche une redirection vers cette URL une fois que le compte connecté a terminé son inscription Connect Onboarding. Ceci ne veut pas dire que toutes les informations requises ont été recueillies, 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 le compte connecté redirigé vers votre return_url, vérifiez l’état du paramètre details_submitted sur son compte de l’une des manières 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 compte connecté est redirigé vers l’URL refresh_url dans les cas suivants :

• Le lien a expiré (quelques minutes se sont écoulées depuis sa création).
• 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 ne peut plus accéder au compte.
• Le compte a été rejeté.

Configurez votre URL refresh_url de manière à ce qu’elle déclenche une méthode permettant à votre serveur d’appeler à nouveau l’API Account Links avec les mêmes paramètres, et de rediriger le compte connecté vers le flux Connect Onboarding pour une expérience fluide.

Un compte connecté qui est redirigé vers votre URL return_url peut ne pas avoir terminé le processus d’inscription. Récupérez son compte et recherchez le paramètre charges_enabled. Si l’inscription du compte n’est pas terminée, invitez-le via l’interface utilisateur à poursuivre l’inscription ultérieurement. Le compte 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 du compte connecté pour savoir si le processus d’inscription est terminé.