Inscrire vos comptes connectésVersion bêta publique

En tant que plateforme, vous devez décider entre collecter toutes les informations requises auprès de vos comptes connectés au début du processus (inscription complète), ou les recueillir progressivement (inscription progressive). L’inscription complète collecte les exigences eventually_due pour le compte, tandis que l’inscription progressive collecte uniquement les exigences currently_due.

Pour déterminer si vous devez utiliser l’inscription complète ou progressive, consultez les exigences relatives aux emplacements et aux fonctionnalités de vos comptes connectés. Stripe s’efforce de minimiser son impact sur les comptes connectés, cependant, les exigences sont susceptibles d’évoluer.

Pour les comptes connectés pour lesquels vous êtes responsable de la collecte des exigences, vous pouvez personnaliser le comportement des exigences futures en utilisant le paramètre collection_options. Pour collecter les exigences futures du compte, définissez collection_options.future_requirements sur include.

Create an Account Link using the connected account ID and include a use_case.account_onboarding.refresh_url and a use_case.account_onboarding.return_url. Stripe redirects the connected account to the refresh URL if the Account Link URL has already been visited, has expired, or is otherwise invalid. Stripe redirects connected accounts to the return URL when they have completed or left the onboarding flow. Additionally, based on the information you need to collect, pass either currently_due or eventually_due for use_case.account_onboarding.collection_options.fields. This example passes eventually_due to use up-front onboarding. For incremental onboarding, set it to currently_due.

curl -X POST https://api.stripe.com/v2/core/account_links \
  -H "Authorization: Bearer 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
" \
  -H "Stripe-Version: 2025-07-30.preview" \
  --json '{
    "account": 
"{{CONNECTED_ACCOUNT_ID}}",
    "use_case": {
        "type": "account_onboarding",
        "account_onboarding": {
            "collection_options": {
                "fields": "eventually_due"
            },
            "configurations": [
                "merchant"
            ],
            "return_url": "https://example.com/return",
            "refresh_url": "https://example.com/refresh"
        }
    }
  }'

Rediriger votre compte connecté vers l’URL de lien de compte

Redirigez le compte connecté vers l’URL de lien de compte pour l’envoyer vers 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 rediriger vers cette URL.

Configurez votre intégration pour écouter les modifications des exigences du compte. Vous pouvez tester la gestion des nouvelles exigences (et la désactivation des paiements et virements qui peut en résulter) en utilisant les cartes de test dotées de déclencheurs.

Renvoyez un compte connecté via l’inscription lorsqu’il est associé à des exigences currently_due ou eventually_due. Il n’est pas nécessaire d’identifier les exigences spécifiques, car l’interface d’inscription sait quelles informations elle doit collecter. Par exemple, si une faute de frappe empêche la vérification de l’identité du propriétaire du compte, l’inscription invite ce dernier à charger une pièce d’identité.

Stripe vous informe de toute mise à jour des exigences à venir affectant vos comptes connectés. Vous pouvez collecter ces informations de manière proactive en examinant les exigences de vos comptes dont le requested_reasons.code est défini sur future_requirements.

Pour les comptes connectés pour lesquels Stripe est responsable de la collecte des exigences, cessez de recevoir des mises à jour concernant les informations d’identité après avoir créé un lien de compte ou une session de compte.

Les comptes stockent les informations d’identité dans le hachage identity.

Gérer les erreurs de vérification

Écoutez l’événement v2.core.account[requirements].updated. Si le compte contient des exigences avec un minimum_deadline.status de currently_due à l’arrivée de la date limite, la fonctionnalité correspondante est désactivée et ces états deviennent past_due.

Laissez vos comptes remplir les exigences de vérification en les dirigeant vers le formulaire de l’inscription hébergée par Stripe.

Le lien de compte nécessite une refresh_url et une return_url pour gérer tous les cas de redirection des comptes connectés vers votre plateforme. Il est important de les mettre en œuvre correctement afin de fournir le meilleur flux d’inscription pour vos comptes connectés.

URL d’actualisation

Votre compte connecté est redirigé vers l’URL refresh_url lorsque :

• Le lien a expiré (quelques minutes se sont écoulées depuis la création du lien)
• Le lien a déjà été visité (le compte connecté a actualisé la page ou a cliqué sur le bouton précédent ou suivant).
• Le lien a été partagé dans une application tierce, comme un client de messagerie, qui tente d’accéder à l’URL pour afficher un aperçu. De nombreux clients visitent automatiquement les liens, ce qui entraîne leur expiration.

Configurez l’adresse refresh_url pour qu’elle appelle une méthode sur votre serveur afin de créer un nouveau Account Link avec les mêmes paramètres et de rediriger le compte connecté vers la nouvelle URL de l’Account Link.

URL de redirection

Stripe redirige le compte connecté vers cette URL lorsqu’il termine le flux d’inscription ou qu’il clique sur Enregistrer pour plus tard à n’importe quel moment du flux. Cela ne signifie pas que toutes les informations ont été recueillies ou que toutes les exigences du compte ont été satisfaites. Cela signifie uniquement que l’entrée et la sortie du flux ont fonctionné correctement.

Cette URL ne transmet aucun état. Après avoir redirigé un compte connecté vers le return_url, déterminez si le compte a terminé son inscription. Récupérez le compte et vérifiez le hachage des exigences pour connaître les exigences en attente. Vous pouvez également écouter l’événement v2.core.account[requirements].updated envoyé à votre endpoint de webhook et mettre en cache l’état du compte dans votre application. Si l’inscription est incomplète, incluez des invites dans votre application pour leur permettre de poursuivre l’inscription plus tard.

L’inscription hébergée par Stripe prend également en charge les mises à jour initiées par le compte connecté des informations qu’il a déjà fournies. Écoutez l’événement v2.core.account[requirements].updated envoyé à votre endpoint de webhook pour recevoir une notification lorsque le compte satisfait aux exigences et met à jour ses informations.

Lorsque vous créez un lien de compte, vous pouvez définir le type sur account_onboarding ou account_update.

Liens de compte pour account_onboarding

Les liens de compte de ce type fournissent un formulaire permettant de saisir des exigences en attente. Utilisez-le lors de l’inscription d’un nouveau compte connecté ou lorsqu’un utilisateur existant a de nouvelles exigences (par exemple, lorsqu’un compte connecté a déjà fourni suffisamment d’informations, mais que vous avez demandé une nouvelle fonctionnalité qui nécessite des informations supplémentaires). Dirigez l’utilisateur vers ce type de lien de compte pour recueillir les nouvelles informations dont vous avez besoin.

Liens de compte pour account_update

Les liens de compte de ce type sont activés pour les comptes dont votre plateforme est responsable du recouvrement des exigences. Les liens account_update affichent les attributs déjà renseignés sur l’objet compte et permettent à votre compte connecté de modifier les informations précédemment fournies (par exemple, pour mettre à jour leur adresse). Ajoutez une option dans votre application (par exemple, « Modifier mon profil » ou « Mettre à jour mes informations de vérification ») pour permettre aux comptes connectés d’effectuer eux-mêmes les mises à jour.