Accéder directement au contenu
Créez un compte
 ou
connecter-vous
Logo de la documentation Stripe
/
Créez un compte
Connectez-vous
Aperçu

Gérez les évolutions des exigences de vérification

Aidez vos comptes connectés à suivre l'évolution des exigences en matière 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.

Obtenir les exigences en matière de risque avec l'API

Dans le cadre de la version bêta, vous pouvez gérer les problèmes de compte liés aux risques actuels et à venir avec l’attribut account.requirements. Pour en savoir plus sur la façon de participer à la version bêta, submit your email.

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

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 du 16-10-2023, les versions antérieures du tableau requirements.errors incluent un champ detailed_code pour renvoyer 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 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 des utilisateurs, vous devez traiter l’évolution des exigences pour vos comptes connectés existants.

Type de flux d’inscriptionDescriptionModifier la responsabilité
Via l’APIVous 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 StripeVotre 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": 
    "{{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": []
  },
  ...
}

    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.

    Command Line
    curl https://api.stripe.com/v1/accounts \
  -u "
    sk_test_4eC39HqLyjWDarjtT1zdp7dc
    :"     \
  -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 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.

    Command Line
    curl https://api.stripe.com/v1/accounts/
    {{CONNECTED_ACCOUNT_ID}}
     \
  -u "
    sk_test_4eC39HqLyjWDarjtT1zdp7dc
    :"
    {
  "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 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 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 Connect.

  • 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 :

    Voir aussi

    Cette page vous a-t-elle été utile ?
    OuiNon
    Besoin d'aide ? Contactez le service d'assistance.
    Rejoignez notre programme d'accès anticipé.
    Consultez notre journal des modifications des produits.
    Des questions ? Contactez l'équipe commerciale.
    Propulsé par Markdoc
    Produits utilisés
    Connect