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.

Ces mises à jour peuvent vous obliger à prendre les mesures suivantes :

1. Modifiez votre processus d’inscription des utilisateurs pour tenir compte des nouvelles exigences.
2. Collectez des informations à jour auprès de vos comptes connectés concernés et gérez les réponses de vérification.
3. Traitez les exigences liées au risque en notifiant les comptes connectés des problèmes identifiés, pour leur montrer comment les résoudre via les interfaces Stripe.

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 pour répondre aux 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.

Considérations relatives à la version de l’API

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 2023-10-16, 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.

Si vous utilisez des liens de compte ou de rectification pour collecter les nouvelles informations exigées, utilisez la version de l’API datée du 07/09/2021 ou une version ultérieure.

Si vous recevez des événements account.updated. Définissez la version de l’API des webhooks sur 2021-09-07 ou une version ultérieure.

Modifier votre flux d’inscription

Options de flux d’inscription

Lorsque les exigences évoluent, nous mettons à jour les flux d’inscription intégrés et hébergés par Stripe pour en tenir compte. 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 des utilisateurs, vous devez traiter l’évolution des exigences pour vos comptes connectés existants.

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.

Modifier votre flux d’inscription basé sur l’API

Prévisualisez les nouvelles exigences de vérification

Lorsque les exigences de vérification évoluent, vous devez collecter les informations mises à jour avant une certaine date limite. Le non-respect des nouvelles exigences pour un compte connecté peut entraîner la désactivation d’une ou plusieurs fonctionnalités de ce compte. 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": 
"{{CONNECTED_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": []
  },
  ...
}

Ajoutez des champs obligatoires à votre flux d’inscription

Lorsque vous avez identifié les informations à jour que vous devez collecter, déterminez s’il convient de les ajouter à votre flux d’inscription. Par exemple, si la mise à jour est une nouvelle exigence qui s’applique toujours à une fonctionnalité et que votre flux d’inscription demande cette fonctionnalité, votre flux doit collecter cette information.

Sinon, si la mise à jour modifie une exigence parce qu’un compte a atteint un seuil, tenez compte de la fréquence à laquelle vos comptes atteignent ce seuil. Si cette fréquence n’est pas élevée, votre flux d’inscription n’a pas besoin d’exiger que chaque nouveau compte connecté fournisse cette information.

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.

curl https://api.stripe.com/v1/accounts \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "controller[stripe_dashboard][type]"=none \
  -d "controller[fees][payer]"=application \
  -d "controller[losses][payments]"=application \
  -d "controller[requirement_collection]"=application \
  -d country=US \
  -d business_type=individual \
  -d "capabilities[card_payments][requested]"=true \
  -d "capabilities[transfers][requested]"=true \
  --data-urlencode email="jenny.rosen+enforce_future_requirements@example.com"

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 true, le compte peut recevoir des virements. Lorsque charges_enabled est true, débloquez les paiements pour le compte.

curl https://api.stripe.com/v1/accounts/
{{CONNECTED_ACCOUNT_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:"

{
  "id": 
"{{CONNECTED_ACCOUNT_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": []
  },
  ...
}

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 motif disabled_reason que vous pouvez utiliser pour déterminer l’action à entreprendre. Pour effectuer des recherches ou fournir les informations requises, recherchez le compte sur la page Comptes connectés de votre Dashboard.

Identifiez les comptes qui ne satisfont pas toutes les exigences

Dans votre Dashboard Connect, sélectionnez Comptes connectés. Vous voyez s’afficher une liste des comptes connectés ayant des exigences actuelles ou futures non satisfaites. Vous pouvez filtrer la liste par type de problème et par é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 applicable à 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 peut entraîner la vérification d’un plus grand nombre de comptes, servez-vous de cette date comme d’un rappel vous incitant à consulter la page Comptes connectés de votre Dashboard.

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.