Gérez les évolutions des exigences de vérification
Pour que vos comptes connectés puissent accepter des paiements et effectuer des virements, vous devez répondre à ce que l’on appelle communément les exigences Know Your Client (KYC). Pour ce faire, vous devez collecter certaines informations concernant vos comptes connectés et les envoyer à Stripe pour vérification.
Stripe met régulièrement à jour les exigences KYC, souvent à la suite de changements apportés par les organismes de réglementation financière, les réseaux de cartes ou d’autres institutions financières.
Get risk requirements with the API
As part of a current beta, you can handle current and upcoming risk-related account issues with the account.requirements attribute. To learn more about how to participate in the beta, submit your email.
Ces mises à jour peuvent vous obliger à prendre les mesures suivantes :
- Modifiez votre processus d’inscription des utilisateurs pour tenir compte des nouvelles exigences.
- Collectez des informations à jour auprès de vos comptes connectés concernés et gérez les réponses de vérification.
Lorsque vos comptes connectés seront concernés par de futures mises à jour des exigences, nous vous en informerons.
Si vous utilisez l’inscription intégrée ou hébergée par Stripe, vous pouvez collecter des informations de manière proactive afin de satisfaire les exigences futures. Pour l’inscription intégrée, incluez l’attribut collectionOptions
dans le composant d’inscription intégrée. Pour l’inscription hébergée par Stripe, spécifiez le paramètre collection_options
lors de la création des liens de compte.
Note
Dans la version de l’API 2023-10-16 et les versions ultérieures, le tableau requirements.errors de l’objet account
spécifie les derniers types d’erreurs de vérification dans l’attribut code
. Nous vous recommandons de mettre à niveau vers la version de l’API 2023-10-16 et d’utiliser requirements.errors
.
Si vous ne pouvez pas effectuer la mise à jour vers la version du 16-10-2023, les versions antérieures du tableau requirements.errors
incluent un champ detailed_code
pour conserver les erreurs de vérification non compatibles avec l’attribut code
. L’attribut detailed_code
n’apparaît pas dans la documentation de l’API.
Modifier votre flux d'inscription
Options de flux d’inscription des utilisateurs
Lorsque les exigences évoluent, nous mettons à jour les flux d’inscription intégrés et hébergés par Stripe pour tenir compte des changements. Toutefois, si vous utilisez un flux d’inscription basé sur une API personnalisée, vous devez le mettre à jour pour prendre en charge les nouvelles exigences.
Quel que soit le type de flux d’inscription, vous devez prendre en compte les modifications des exigences pour vos comptes Custom existants.
Type de flux d’inscription | Description | Modifier la responsabilité |
---|---|---|
Via l’API | Vous créez des flux personnalisés à l’aide des API Stripe pour vos comptes connectés. Votre intégration doit répondre à toutes les exigences d’inscription de Stripe. | Il vous appartient d’identifier les nouvelles exigences et de mettre à jour vos flux pour les gérer. |
Intégrée new | (Méthode recommandée) Vos comptes connectés interagissent avec une interface utilisateur hautement thématisable et personnalisable dans un composant intégré, sans quitter votre application. | Vous n’avez pas à mettre à jour votre flux d’inscription lorsque les exigences évoluent. Stripe met automatiquement à jour les composants d’inscription intégrés en conséquence. |
Hébergée par Stripe | Votre application redirige vos comptes connectés vers Stripe pour finaliser le processus d’inscription dans une interface comarquée. | Vous n’avez pas à mettre à jour votre flux d’inscription lorsque les exigences évoluent. Stripe actualise automatiquement le flux d’inscription hébergée en conséquence. |
Si vous utilisez des composants intégrés ou une inscription hébergée par Stripe, les modifications des exigences ne nécessitent pas de mise à jour de votre flux d’inscription. Passez directement à la section consacrée à la collecte des informations à jour.
Si vous utilisez un flux d’inscription via une API personnalisée, gérez les nouvelles exigences en suivant ces étapes ou en remplaçant votre flux d’inscription par des composants intégrés ou une inscription hébergée par Stripe.
Note
Vous ne pouvez pas utiliser l’API pour répondre aux vérifications des risques de Stripe. Vous pouvez autoriser vos comptes connectés à répondre à l’aide de composants intégrés, d’une procédure d’inscription hébergée par Stripe ou de liens de rectification. Vous avez également la possibilité d’utiliser le Dashboard pour répondre à des vérifications des risques au nom de vos comptes connectés.
Modifier votre flux d’inscription via l’API
Prévisualiser les nouvelles exigences de vérification
Lorsque les exigences de vérification évoluent, vous devez collecter les informations à jour avant une certaine date, faute de quoi vos comptes connectés ne pourront pas utiliser les fonctionnalités que vous demandez (par exemple, card_payments
). Consultez le détail des informations que vous devez collecter en fonction de la région du compte, des fonctionnalités demandées et d’autres facteurs.
Vous pouvez éviter toute interruption des fonctionnalités de vos comptes connectés en planifiant la collecte des informations à jour avant la current_deadline
. Pour prendre connaissance des modifications des exigences futures, examinez le hachage future_requirements de l’objet Account.
{ "id":
, "object": "account", "future_requirements": { "current_deadline": 1656608400, "currently_due": [ "company.tax_id" ], "disabled_reason": null, "errors": [], "eventually_due": [ "company.tax_id" ], "past_due": [], "pending_verification": [] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Note
Si vous utilisez Stripe Data, vous pouvez récupérer le hachage future_requirements
à l’aide d’une requête Sigma.
Ajoutez les champs obligatoires à votre flux d’inscription
Une fois que vous avez identifié les informations à jour que vous devez collecter, ajoutez les champs correspondants à votre flux d’inscription et mettez à jour vos comptes connectés à l’aide de l’API Accounts.
Pour éviter toute interruption des fonctionnalités de vos comptes connectés, demandez à votre flux d’inscription de répondre à toutes les exigences énumérées dans la liste future_requirements.currently_due de l’objet Account.
Vous pouvez également vous préparer aux exigences qui s’appliqueront lorsqu’un compte atteindra les seuils fixés en consultant la liste future_requirements.eventually_due.
Testez votre flux d’inscription mis à jour
Pour simuler des exigences de vérification futures, créez un compte de test à l’aide de l’API Accounts avec enforce_future_requirements
dans le champ de l’e-mail. Cela renseigne le hachage requirements
du compte avec toutes les futures exigences de vérification connues.
Pour vérifier que votre flux d’inscription mis à jour répond aux exigences du compte, inscrivez le compte de test et vérifiez son hachage requirements
. Si votre flux couvre toutes les exigences, la liste currently_due est vide.
Écoutez les changements d’état du compte pour activer la fonctionnalité
Détectez les changements d’état du compte en écoutant l’événement account.updated
. Une fois qu’un compte a été soumis à votre flux d’inscription, inspectez les listes currently_due
et pending_verification
dans le hachage requirements
du compte. Lorsque les deux sont vides, et que requirements.disabled_reason
est null, vous pouvez activer la fonctionnalité pour le compte. Lorsque payouts_enabled
est défini sur true, le compte peut recevoir des virements. Lorsque charges_enabled
est défini sur true, débloquez les paiements pour le compte.
{ "id":
, "object": "account", "charges_enabled": true, "payouts_enabled": true, "requirements": { "alternatives": [], "current_deadline": null, "currently_due": [], "disabled_reason": null, "errors": [], "eventually_due": [], "past_due": [], "pending_verification": [] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Collecter des informations à jour auprès de vos comptes qui ne satisfont pas toutes les exigences
Vous pouvez collecter les informations à jour auprès de vos comptes connectés à l’aide de composants intégrés, de l’inscription hébergée par Stripe ou de l’API Stripe. Nous vous recommandons d’intégrer des composants intégrés ou de diriger vos comptes connectés vers l’inscription hébergée par Stripe à l’aide d’Account Links.
Dans tous les cas, suivez ces étapes :
Adaptez votre intégration pour gérer les nouvelles réponses de vérification
Lorsque Stripe reçoit des informations à jour sur vos comptes connectés, la vérification des champs des comptes associés prend du temps. Tant que nous n’avons pas terminé la vérification, toutes les fonctionnalités associées restent désactivées. Pour détecter les mises à jour de vérification des champs, écoutez les événements account.updated et examinez les erreurs de vérification. Si vous ne résolvez pas une erreur avant la date limite, les fonctionnalités demandées sont désactivées pour les comptes concernés.
Le hachage requirements
d’une fonctionnalité désactivée contient un paramètre disabled_reason que vous pouvez utiliser pour déterminer l’action à entreprendre. Pour effectuer des recherches ou fournir les informations requises, rendez-vous sur l’onglet Comptes à vérifier du Dashboard de Connect.
Identifiez les comptes qui ne satisfont pas toutes les exigences
Dans votre Dashboard Connect, sélectionnez comptes à vérifier. Cela affiche la liste des comptes connectés présentant des exigences actuelles ou futures à satisfaire. Vous pouvez filtrer la liste par problème et état du compte.
Vous pouvez également voir les informations que chaque compte connecté doit fournir, ainsi que la date limite, dans le hachage future_requirements de l’objet du compte ou en utilisant une requête Sigma.
Préparez-vous à l’entrée en vigueur des nouvelles exigences
À la date d’entrée en vigueur des exigences d’un compte (future_requirements.current_deadline
), le contenu du hachage future_requirements
est déplacé vers le hachage requirements
et Stripe génère un événement account.updated. Dans la mesure où l’entrée en vigueur de nouvelles exigences peut occasionner une hausse du nombre de comptes à vérifier, utilisez la date d’entrée en vigueur comme un rappel pour examiner l’onglet Comptes à vérifier du Dashboard de Connect.
Note
Nous prévoyons de mettre en place une fonctionnalité qui vous permettra de commencer à faire respecter les exigences avant la date limite en appliquant les nouvelles exigences de vérification aux comptes connectés. Cela vous permettra d’identifier et de résoudre de manière proactive les problèmes que comporte votre intégration mise à jour en appliquant progressivement des exigences aux comptes connectés.
Dirigez les comptes connectés vers le flux de collecte d’informations
Si un compte présente des exigences currently_due ou des erreurs de vérification, vous devez les corriger avant la current_deadline. À cette date, les exigences du tableau requirements.currently_due
sont ajoutées au tableau requirements.past_due
et toutes les fonctionnalités associées sont désactivées jusqu’à ce que vous fournissiez les informations et résolviez les erreurs.
Les exigences futures peuvent immédiatement affecter les fonctionnalités d’un compte dès lors qu’elles deviennent des exigences actuelles. Veillez à traiter toutes les exigences avant leur échéance, même si elles se trouvent encore dans future_requirements
.
Lorsque vos comptes ont des requirements
qui sont currently_due
, demandez à vos comptes de résoudre les éventuels problèmes en fonction de votre flux d’inscription ou à l’aide de liens de rectification :
- Inscription via l’API : utilisez votre flux d’inscription personnalisé, en collectant également les
future_requirements
si vous le souhaitez. - Inscription intégrée : affichez le composant d’inscription intégré pour vos comptes concernés.
- Inscription hébergée par Stripe : Utilisez l’API Account Links pour générer un lien à usage unique vers l’inscription hébergée par Stripe. Dirigez vos comptes connectés vers ce lien depuis votre application.
- Liens de rectification : utilisez le Dashboard pour générer des liens de rectification que vos comptes connectés peuvent utiliser pour fournir les informations requises.