Traiter les vérifications avec l'API
Les plateformes dont les comptes ont été créés à l’aide de l’API sont en mesure de fournir à Stripe les informations nécessaires dans le cadre des exigences Know Your Customer (KYC). Les plateformes peuvent utiliser le flux d’inscription Connect Onboarding pour collecter les informations KYC, ou les API Accounts et Persons pour fournir à Stripe les informations requises. Nous procéderons ensuite à la vérification puis demanderons des informations supplémentaires si nécessaire.
Le reste de cette page explique comment les plateformes peuvent :
- Exigences de vérification des comptes connectés
- Fournir les informations requises à Stripe
Les plateformes utilisant des comptes connectés Custom peuvent également consulter le guide Vérification d’identité pour les comptes Custom afin de découvrir quels sont les flux de vérification possibles, à quoi correspondent les champs de l’API tant pour les entreprises que pour les particuliers, et comment localiser des demandes d’information.
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.
Processus de vérification
Pour activer les paiements et virements d’un compte connecté, Stripe a besoin de certaines informations dont la nature varie en fonction :
- Pays d’origine des comptes connectés
- Le type de contrat de service applicable aux comptes connectés
- Fonctionnalités demandées pour les comptes connectés
- Type (par exemple particulier ou entreprise) et structure de l’entreprise (par exemple, société anonyme ou société de personnes)
Platforms need to choose the proper onboarding flow for their business and users to meet the KYC requirements. Broadly speaking, this means providing all the requisite information upfront or incrementally. Either way, set up your integration to watch for and respond to requests from Stripe.
- Mettez en place une URL de webhook Connect dans vos paramètres de webhook afin de surveiller l’activité, en particulier les événements de type
account.updated
. Si vous utilisez l’API Persons, surveillez aussi les événementsperson.updated
. - Immediately after creating an account, check the
Account
object’s requirements.currently_due attribute for any additional requirements. Obtain any required information from the user and update the connected account. - Continuez de surveiller les notifications d’événement
account.updated
pour être informé des changements de l’algorithme de hachagerequirements
et demander d’éventuelles informations complémentaires à votre utilisateur.
When you provide additional information, you don’t need to resubmit any previously verified details. For example, if the dob
is already verified, you don’t need to provide it again in subsequent updates.
Mise en garde
When requirements.currently_due
isn’t empty, additional information is required. Connected accounts might be blocked from creating charges, receiving payouts, or performing certain tasks if you don’t provide this information in a timely manner.
Modifier des informations après vérification
After an individual or company is verified, you can change some of their information, with limitations. See the Update Account API for limitations based on the configuration of the connected account. Contact support to make changes outside of these limitations.
Déterminer si une vérification est nécessaire
Lorsque vous recevez un événement account.updated
sur votre webhook ou que vous récupérez un compte avec l’API, vous recevez un objet Account. Les paramètres charges_enabled
et payouts_enabled
de l’objet Account
indiquent si le compte peut créer des paiements et accepter des virements.
L’objet Account
a un hachage requirements
, qui représente les exigences de vérification du compte.
Le hachage des requirements
contient les matrices suivantes :
eventually_due
: les champs que vous devrez peut-être collecter, en supposant que tous les seuils soient atteints. Lorsque ces champs deviennent obligatoires, ils apparaissent danscurrently_due
et définissent lacurrent_deadline
. Toutes les informations obligatoires sont issues de ce tableau.currently_due
: les champs que vous devez collecter avant lacurrent_deadline
pour que le compte connecté reste actif.currently_due
est un sous-ensemble deeventually_due
.past_due
: les champs que vous n’avez pas soumis avant la date limite, conduisant à la désactivation du compte connecté.past_due
est un sous-ensemble decurrently_due
.errors
: liste des motifs pour lesquels un champ particulier à l’étateventually_due
,currently_due
oupast_due
doit faire l’objet d’une nouvelle collecte après échec de la validation ou de la vérification.disabled_reason
: la raison pour laquelle le compte connecté n’est pas activé.current_deadline
: date avant laquelle les champs à l’étatcurrently_due
doivent être collectés pour éviter une désactivation du compte. La désactivation peut survenir plus tôt si le seuil suivant est atteint avant la collecte des champscurrently_due
.pending_verification
: Champs qui peuvent devenir obligatoires en fonction des résultats de la vérification ou de l’examen. Il s’agit d’un tableau vide, sauf si une vérification asynchrone est en cours. Si la vérification échoue, ces champs sont placés danseventually_due
,currently_due
oupast_due
. Des champs peuvent apparaître danseventually_due
,currently_due
oupast_due
et danspending_verification
si la vérification échoue mais qu’une autre vérification est encore en cours.
L’exemple ci-dessous illustre l’algorithme de hachage requirements
pour un compte dont certaines informations figurent dans currently_due
, d’autres dans eventually_due
et d’autres ont généré des errors
de vérification.
{ "id":
, "object": "account", "requirements": { "disabled_reason": null, "current_deadline": 1529085600, "past_due": [], "currently_due": [ "company.tax_id", "company.verification.document", "tos_acceptance.date", "tos_acceptance.ip" ], "eventually_due": [ "company.address.city", "company.address.line1", "company.address.postal_code", "company.address.state", "company.tax_id", "company.verification.document", "external_account", "tos_acceptance.date", "tos_acceptance.ip" ], "errors": [ { "requirement": "company.verification.document", "reason": "The company name on the account couldn't be verified. Either update your business name or upload a document containing the business name.", "code": "failed_name_match" }, ] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
If requirements.currently_due
contains entries, check requirements.current_deadline
. The current_deadline
is a Unix timestamp identifying when information is needed. Usually, if Stripe doesn’t receive the information by the current_deadline
, payouts on the account are disabled. However, other consequences might apply in some situations. For example, if payouts are already disabled and the account is unresponsive to our inquiries, Stripe might also disable the ability to process charges.
Par ailleurs, la propriété requirements.disabled_reason peut avoir une valeur. La valeur est une chaîne décrivant la raison pour laquelle ce compte n’est pas en mesure d’effectuer des virements ou des paiements. Dans certains cas, les plateformes et les comptes connectés peuvent soumettre un formulaire pour résoudre le problème ou faire appel.
- Les comptes connectés Standard peuvent accéder à des informations supplémentaires (le cas échéant) dans leur Dashboard.
- Quelle que soit la configuration de Connect, les plateformes peuvent accéder aux comptes à vérifier pour comprendre le
disabled_reason
d’un compte. Vous pouvez fournir des informations supplémentaires au nom de vos comptes connectés. Si le motif de désactivation est associé à un appel, vous pouvez générer un lien vers un formulaire permettant au compte de résoudre l’appel.
Motif | Signification |
---|---|
action_required.requested_capabilities | Vous devez demander les fonctionnalités pour le compte connecté. Pour en savoir plus, consultez la page Demander et annuler une demande de fonctionnalités. |
listed | Account might be on a prohibited persons or companies list (Stripe investigates and either rejects or reinstates the account accordingly). |
rejected.fraud | Le compte a été rejeté pour suspicion de fraude ou d’activités illégales. |
rejected.incomplete_verification | Le compte est rejeté, car les exigences de vérification n’ont pas été satisfaites dans le délai requis. |
rejected.listed | Le compte a été rejeté, car il figure sur une liste de personnes ou activités prohibées (par exemple une liste émanant d’un prestataire de services ou d’un gouvernement). |
rejected.other | Le compte a été rejeté pour un autre motif. |
rejected.terms_of_service | Le compte a été rejeté pour suspicion d’infraction aux Conditions d’utilisation du service. |
requirements.past_due | Des informations de vérification supplémentaires sont requises pour activer les fonctionnalités sur ce compte. |
requirements.pending_verification | Stripe vérifie actuellement les informations du compte connecté. Aucune action n’est requise. Consultez le tableau requirements.pending_verification pour prendre connaissance des informations en cours de vérification. |
under_review | Le compte est en cours de vérification par Stripe. |
Erreurs de validation et de vérification
L’objet Account contient un tableau requirementserrors qui explique pourquoi les exigences de validation ou de vérification nécessaires à l’activation de votre compte et ses fonctionnalités ne sont pas remplies. Le tableau errors
possède les attributs suivants :
requirement
: indique quelles informations de la tablecurrently_due
sont requises.code
: indique le type d’erreur rencontré. Pour consulter la liste intégrale des codes d’erreur possibles, consultez la documentation de l’API.reason
: explique pourquoi l’erreur s’est produite et comment la résoudre.
L’exemple ci-dessous montre à quoi peut ressembler le tableau errors
pour un compte dont les exigences sont définies sur currently_due
. Cet exemple montre la raison pour laquelle les informations envoyées ne peuvent pas être utilisées pour activer le compte et explique comment résoudre l’erreur. Si la vérification ou la validation échoue, les exigences peuvent réapparaître dans currently_due
avec des informations sur les erreurs. Définissez un webhook Connect pour recevoir l’événement account.updated
et obtenir ces mises à jour.
{ "id":
, "object": "account", "requirements": { "current_deadline": 1234567800, "currently_due": [ "company.address.line1", "{{PERSON_ID}}.verification.document", ], "errors": [ { "requirement": "company.address.line1", "code": "invalid_street_address", "reason": "The provided street address cannot be found. Please verify the street name and number are correct in \"10 Downing Street\"", }, { "requirement": "{{PERSON_ID}}.verification.document", "code": "verification_document_failed_greyscale", "reason": "Greyscale documents cannot be read. Please upload a color copy of the document.", } ] }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Si la vérification ou la validation échoue, mais qu’aucune exigence n’est requise actuellement, un webhook se déclenche pour signaler une information requise dans le futur.
Informations concernant l’entreprise
When information about a business is submitted, Stripe verifies the new information. For example, Stripe might verify that the provided business URL is valid, reachable, and includes information about the business. To retrieve the status of verification information regarding a business, utilize the requirements
on the Account object.
Vous trouverez ci-dessous une liste d’erreurs liées à la vérification des informations de l’entreprise :
Erreur | Résolution |
---|---|
invalid_business_profile_name | Les noms d’entreprise doivent être faciles à comprendre et composés de mots facilement reconnaissables. |
invalid_business_profile_name_denylisted | Les noms d’entreprise génériques ou particulièrement connus ne sont pas pris en charge. Assurez-vous que le nom d’entreprise fourni correspond à celui figurant sur le compte de l’entreprise. |
invalid_product_description_length | La description d’un produit doit comporter au moins 10 caractères. |
invalid_product_description_url_match | La description d’un produit doit être différente de l’URL de l’entreprise. |
| Consultez la section Gestion des erreurs de vérification d’URL ci-dessous. |
Libellés de relevé bancaire
Stripe valide le libellé de relevé bancaire et son préfixe lorsqu’ils sont configurés pour un compte. Par exemple, Stripe peut vérifier que le libellé fourni correspond à la description de l’entreprise. Pour ce faire, Stripe examine les 22 premiers caractères du libellé de relevé bancaire, représentant la partie transmise aux réseaux de cartes. La description de l’entreprise doit être presque identique au business_profile.name
, à l’URL business_profile.url
du compte ou au nom de l’entreprise ou du particulier titulaire du compte.
Pour récupérer l’état des informations de vérification concernant les libellés de relevé bancaire, vérifiez les requirements
sur l’objet Account. Vous trouverez ci-dessous une liste d’erreurs liées à la vérification des libellés de relevé bancaire :
Erreur | Résolution |
---|---|
invalid_statement_descriptor_length | Un libellé de relevé bancaire doit comporter au moins 5 caractères. |
invalid_statement_descriptor_business_mismatch | Un libellé de relevé bancaire doit correspondre à la dénomination sociale, au nom de l’entité juridique ou à l’URL du compte. |
| Les libellés de relevé bancaire génériques ou particulièrement connus ne sont pas pris en charge. |
invalid_statement_descriptor_prefix_mismatch | Le préfixe de libellé de relevé bancaire doit correspondre à votre libellé de relevé bancaire, au nom de votre entreprise, à la dénomination de votre entité juridique ou à votre URL. |
Informations sur les personnes
Lors du processus de vérification, des informations concernant la personne associée au compte doivent être recueillies. Si vous inscrivez :
- Uniquement des entreprises, utilisez l’API Persons pour recueillir ces informations.
- Uniquement des particuliers, utilisez l’API Persons ou l’algorithme de hachage individual de l’objet Account.
- À la fois des particuliers et des entreprises, utilisez l’API Persons pour recueillir ces informations. Cela vous permettra d’utiliser la même méthode de collecte des informations, quel que soit le type de structure de l’entreprise.
Pour connaître l’état des informations de vérification concernant une personne, utilisez le sous-hachage verification de l’objet Person :
{ "id":
, "object": "person", ... "verification": { "document": null } ... }"{{PERSON_ID}}"
Vous pouvez rechercher la définition de chaque attribut de vérification dans l’objet Person. Les deux attributs les plus importants sont status
et details
.
L’attribut status
indique l’état de vérification de la personne :
pending
: Stripe effectue actuellement la vérification de cette entité.unverified
: Stripe n’est pas en mesure de vérifier cette entité à l’heure actuelle, soit parce que la vérification a échoué ou parce que nous ne disposons pas de suffisamment d’informations pour procéder à la vérification.verified
: Stripe a vérifié cette entité.
Veuillez noter qu’un état unverified
ne constitue pas nécessairement un problème urgent. En revanche, cela signifie que Stripe risque de bientôt demander des informations complémentaires.
L’attribut details
fournit une explication du status
actuel.
Vous trouverez ci-dessous une liste d’erreurs liées à la vérification des personnes :
Erreur | Résolution |
---|---|
invalid_address_city_state_postal_code | Stripe n’a pas pu valider la combinaison de la ville, de l’État et du code postal de l’adresse fournie. |
invalid_address_highway_contract_box | The address of the person must be a valid physical address from which the account conducts business and can’t be a Highway Contract Box. |
invalid_address_private_mailbox | The address of the person must be a valid physical address from which the account conducts business and can’t be a private mailbox. |
invalid_dob_age_under_minimum | La personne doit avoir au moins 13 ans. |
invalid_dob_age_over_maximum | La date de naissance de la personne doit se situer dans les 120 dernières années. |
invalid_phone_number | Stripe n’a pas pu valider le numéro de téléphone du compte. Assurez-vous que le formatage correspond au pays de la personne. |
invalid_street_address | Stripe n’a pas pu valider le nom et/ou le numéro de rue de l’adresse fournie. |
| Les numéros fiscaux doivent être saisis sous la forme d’un numéro unique à 9 chiffres, sans tiret ni caractères spéciaux. |
Documents de vérification valides par pays
Vous trouverez ci-dessous la liste des documents que vous pouvez adresser à Stripe afin de vérifier votre identité, adresse et entité juridique, pour chacun des pays pris en charge par Stripe.
Pour certains documents, vous devez obligatoirement fournir une copie du recto et du verso. Dans ce cas, utilisez le paramètre document_back
pour fournir le verso du document. En l’absence d’indication, seule une copie du recto du document est requise.
Stripe only accepts a passport to verify someone’s identity when a Stripe account and an individual associated with that Stripe account (for example, Business Representative, Owner) are from different countries. For example, if the business address is in the US, but the representative or owner of the business has a non-US address, then only their passport is accepted for verification of their identity. A passport scan is the only acceptable document in these cross-border situations.
Informations sur l’entreprise
Lors du processus de vérification, vous serez peut-être amené à recueillir des informations sur l’entreprise d’un compte.
Pour connaître l’état des informations de vérification concernant une entreprise, utilisez le sous-hachage company.verification du compte :
{ "id":
, "object": "account", ... "company": { "verification": { "document": null }, ... }, ... }"{{CONNECTED_ACCOUNT_ID}}"
Vous pouvez rechercher la définition de chaque attribut de vérification dans l’objet Account.
Gérer les problèmes de vérification des documents
De nombreux problèmes de vérification sont dus au chargement du document. Afin de vous aider à reconnaître et traiter les problèmes les plus courants, le tableau ci-dessous liste toutes les valeurs possibles du code
d’erreur (dans le tableau requirements.errors
) et indique la solution probable de chacune de ces erreurs.
Les erreurs ci-dessous sont liées au chargement du document :
Erreur | Résolution |
---|---|
| Le chargement a échoué en raison d’un problème au niveau du fichier. Veuillez demander à votre utilisateur de fournir un nouveau fichier respectant ces critères :
|
| The provided file isn’t an acceptable form of ID from a supported country, or isn’t a type of legal entity document that is expected. Ask your user to provide a new file that meets that requirement. For a list, see Acceptable ID types by country. |
| Your team can contact Stripe to learn more about why identity verification failed. |
| La date d’émission ou d’expiration du document est manquante ou le document est expiré. S’il s’agit d’une pièce d’identité, vous devez nous l’envoyer avant sa date d’expiration. S’il s’agit d’un justificatif d’adresse, il doit être émis depuis moins de six mois. |
Les erreurs ci-dessous sont liées à la vérification d’identité :
Erreur | Résolution |
---|---|
verification_failed_keyed_identity | Le nom du compte n’a pas pu être vérifié. Veuillez demander à votre utilisateur d’indiquer son nom complet et de fournir une pièce d’identité avec photo qui corresponde à ce nom. |
| Les informations de la pièce d’identité ne correspondent pas aux informations fournies par l’utilisateur. Veuillez demander à votre utilisateur de vérifier puis corriger les informations fournies sur le compte. |
| The document might have been altered so it couldn’t be verified. Your team can contact Stripe to learn more. |
Les erreurs ci-dessous sont liées à la vérification d’entreprise :
Erreur | Résolution |
---|---|
| Les informations du compte n’ont pas pu être vérifiées. Votre utilisateur peut charger un document pour confirmer les informations de son compte ou modifier ces informations. |
| Les informations fournies par votre utilisateur n’ont pas pu être vérifiées auprès de l’IRS. Veuillez demander à votre utilisateur de corriger d’éventuelles erreurs de saisie du nom de l’entreprise ou du numéro fiscal, ou de charger un document confirmant les informations de ces champs. (États-Unis uniquement) |
| Les informations du document ne correspondent pas aux informations fournies par l’utilisateur. Veuillez demander à votre utilisateur de vérifier puis corriger les informations fournies sur le compte ou de charger un document confirmant les informations du compte. |
| L’un des champs requis ne figure pas sur le document. Veuillez demander à votre utilisateur de charger un autre document confirmant le champ manquant. |
Mise en garde
Ne renvoyez pas un fichier ayant généré un échec. Les envois de fichier en double génèrent automatiquement une erreur et ne sont pas revérifiés.
Gérer les erreurs de vérification d’URL
Les URL des entreprises d’e-commerce doivent se conformer aux normes des réseaux de cartes. Consultez la liste de contrôle pour les sites Web afin de connaître les bonnes pratiques en matière d’URL et les éléments les plus courants pour les entreprises d’e-commerce. Stripe effectue un certain nombre de vérifications de l’intégrité des URL. Il existe deux méthodes pour résoudre les erreurs d’intégrité des URL :
- Utilisation de l’API : utilisez le code d’erreur pour gérer le problème d’URL. Si vous devez mettre à jour l’URL, utilisez l’API Update Account, qui permet également à Stripe de vérifier l’URL mise à jour. Si vous n’avez pas besoin de mettre à jour l’URL, Stripe doit quand même effacer l’erreur en vérifiant à nouveau l’URL. Après avoir effectué les mises à jour requises, déclenchez la revérification en utilisant l’API pour remplacer l’URL par une autre valeur, puis redéfinissez-la.
- Utilisation du Dashboard : les plateformes peuvent utiliser la page Comptes à vérifier du Dashboard Stripe pour comprendre l’impact sur leurs comptes connectés et les actions à entreprendre.
L’API ne permet pas de résoudre tous les problèmes liés aux URL. Certains types d’erreurs d’intégrité d’URL nécessitent des informations supplémentaires sur la manière d’accéder à la page Web du compte connecté ou pour attester que le compte est exempté des exigences relatives aux URL. Ce type de problème nécessite que vous ou votre compte connecté fournissiez des informations supplémentaires. Rendez-vous sur votre page Comptes à vérifier pour résoudre l’erreur, ou contactez le service d’assistance Stripe pour votre compte connecté.
Note
Stripe’s Terms of Service requires all e-commerce businesses to populate the business_profile.url property with a working URL of their business website when activating an account with the card_payments
capability. An account is considered an e-commerce business if it promotes or sells any products or services through an online website, social media profile, or mobile application. If the account doesn’t operate a website to promote their business, sell products, or accept payments, they’re required to provide business_profile.product_description instead. A product description needs to detail the type of products being sold as well as the manner in which the account’s customers are being charged (i.e. in person transactions).
Pour vous aider à gérer les erreurs les plus courantes associées au champ business_profile.url
, le tableau suivant présente les codes d’erreur associés (dans le tableau requirements.errors
) et les résolutions possibles.
Erreur | Résolution |
---|---|
invalid_url_denylisted | L’URL fournie pour le compte correspond à l’URL générique d’un site Web d’entreprise. Une URL spécifique à l’entreprise du compte doit être fournie. |
invalid_url_format | L’URL fournie pour le compte n’est pas au bon format. Veuillez fournir une URL dans un format valide, tel que https://example.com . |
invalid_url_website_inaccessible | Nous ne pouvons pas accéder au site Web correspondant à l’URL fournie pour le compte. Pour résoudre ce problème, mettez à jour le compte en indiquant une URL accessible. Si le problème persiste, accédez à la page Comptes à vérifier du Dashboard et effectuez les actions figurant dans la liste des Actions requises ou contactez le service d’assistance Stripe. |
invalid_url_website_business_information_mismatch | Les informations figurant sur le site Web du compte ne correspondent pas à celles du compte Stripe. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Sinon, le compte doit s’assurer que les informations figurant sur le site Web correspondent à l’entreprise du compte. |
invalid_url_website_incomplete | Certaines informations requises ne semblent pas avoir été renseignées sur le site Web du compte. En savoir plus sur les informations qu’un site Web doit inclure. |
invalid_url_website_other | Nous ne sommes pas en mesure de vérifier l’entreprise du compte à l’aide de l’URL du site Web, du profil de réseau social ou de l’application mobile fourni. Une nouvelle URL doit être fournie. Consultez votre page Comptes à vérifier. Dans le cas contraire, le compte doit contacter le service d’assistance Stripe en l’absence d’URL. |
invalid_url_web_presence_detected | We have detected that the account uses a website, social media profile, or mobile application to sell or promote products or services, but a URL hasn’t been provided for the account. The account should have a URL that isn’t a generic URL for the website or social media provider. |
invalid_url_website_incomplete_customer_service_details | Le site Web du compte ne contient pas les informations du service client, qui sont requises pour le type d’entreprise du compte. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit ajouter ces informations sur son site Web. |
invalid_url_website_incomplete_return_policy | Le site Web du compte ne présente pas de politique ni de processus de retour, qui sont requis pour le type d’entreprise du compte. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit ajouter une politique et un processus de retour sur son site Web. |
invalid_url_website_incomplete_refund_policy | Le site Web du compte ne contient pas de politique de remboursement, qui est requise pour le type d’entreprise du compte. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit ajouter une politique de remboursement sur son site Web. |
invalid_url_website_incomplete_cancellation_policy | Le site Web du compte ne contient pas de politique d’annulation, qui est requise pour le type d’entreprise du compte. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit ajouter une politique d’annulation sur son site Web. |
invalid_url_website_incomplete_legal_restrictions | Le site Web du compte laisse entendre qu’il vend des biens soumis à des restrictions légales ou à l’exportation. Affichez votre page Comptes à vérifier. Dans le cas contraire, le compte doit supprimer ces biens de son site Web. |
invalid_url_website_incomplete_terms_and_conditions | Le site Web du compte ne contient pas les conditions générales, qui sont requises en fonction du type d’entreprise du compte. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit ajouter les conditions générales sur son site Web. |
invalid_url_website_incomplete_under_construction | Le site Web du compte est en construction. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit achever la construction de son site Web. |
invalid_url_website_inaccessible_password_protected | Le site Web du compte est protégé par un mot de passe. Veuillez afficher la page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit contacter le service d’assistance Stripe pour lui donner les instructions nécessaires afin d’accéder au site Web. |
invalid_url_website_inaccessible_geoblocked | Stripe n’a pas pu accéder au site Web du compte, car il est géobloqué. Veuillez afficher la page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit contacter le service d’assistance Stripe pour lui donner les instructions nécessaires afin d’accéder au site Web. |
invalid_url_website_empty | Le site Web du compte ne présente aucun contenu. Veuillez afficher votre page Comptes à vérifier dans le Dashboard. Dans le cas contraire, le compte doit ajouter du contenu représentant ses produits et services. |
Gérer la vérification d’identité
You can respond in two ways to an identity verification change. The first is to perform an Update Account call, correcting or adding information.
Pour la deuxième méthode, nous vous demanderons probablement de charger un document. Selon le nombre d’informations utilisateur que Stripe aura pu vérifier, nous pourrons vous demander trois différents types de documents. Pour savoir quel document charger, vous pouvez vous référer aux champs listés dans requirements.currently_due
:
person.verification.document
: nécessite une photographie ou copie numérisée en couleur d’une pièce d’identité acceptée.person.verification.additional_document
: nécessite une photographie ou copie numérisée en couleur d’un document qui confirme l’adresse de l’utilisateur, par exemple une facture d’eau ou d’électricité.company.verification.document
: nécessite un justificatif sur lequel figure l’identifiant de l’entité commerciale, par exemple les statuts de l’entreprise.
Le chargement d’un document s’effectue en deux étapes :
- Charger le fichier sur Stripe
- Associer le fichier au compte
Note
Pour des raisons de sécurité, Stripe n’accepte pas les copies de pièces d’identité envoyées par e-mail.
Charger un fichier
Pour charger un fichier, utilisez l’API Create File en utilisant un POST pour envoyer les données du fichier dans le cadre d’une requête de type multipart/form-data.
Le fichier chargé doit respecter les critères suivants :
- Image en couleur (de 8 000 pixels par 8 000 pixels maximum)
- 10 Mo maximum
- Identity documents are JPG or PNG format
- Address or legal entity documents are JPG, PNG, or PDF format
Transmettez les données du fichier dans le paramètre file
puis définissez le paramètre purpose
sur identity_document
:
Cette requête charge le ficher et renvoie un token :
{ "id":
, "created": 1403047735, "size": 4908 }"{{FILE_ID}}"
Vous pouvez ensuite utiliser la valeur id
du token pour associer le fichier à un compte connecté à des fins de vérification d’identité.
Joindre un fichier
After you upload the file and receive a representative token, provide the file ID using the appropriate field in your Update Account call.
L’exemple ci-dessous concerne une pièce d’identité :
L’exemple ci-dessous concerne un justificatif d’entreprise :
Cette mise à jour fait passer l’attribut verification.status
à l’état pending
. Si vous devez vérifier une personne supplémentaire, mettez-la à jour à l’aide de l’API Persons.
Confirmer la vérification d’identité
Si la photographie ou la copie numérisée en couleur de la pièce d’identité passe les contrôles de Stripe, l’exigence relative au document est supprimée de requirements.currently_due
. Répondre à toutes les exigences de vérification d’une personne ou d’une entreprise déclenche une notification de webhook account.updated
, indiquant que le processus de vérification est terminé.
Le temps nécessaire aux vérifications de Stripe va de quelques minutes à quelques jours, en fonction de la lisibilité de l’image fournie.
If the verification attempt fails, the requirements.errors
array contains an error stating the cause. The error[reason]
, such as “The image supplied isn’t readable,” is safe to present to your user, but isn’t localized. The response also contains an error[code]
value, such as verification_document_not_readable
, which you can use to localize errors for your users. Upon failure, requirements.currently_due
indicates that a new ID upload is required. If the deadline for verification is near, requirements.current_deadline
might also be populated with a date. Verification failure also triggers an account.updated
webhook notification.
Interested in receiving risk-related requirements?
Thank you! We'll be in touch soon.