requested_information contient des éléments, soumettez les réponses avec Mettre à jour une vérification.
Remplace la ressource Legacy Vérifications. Les intégrations Legacy existantes continuent de fonctionner ; consultez Versions de l’API pour le contrat de stabilité.
Endpoints
Attributs
Comptes pour lesquels cette vérification a été lue, chacun préfixé par
biz_ : le compte par lequel vous avez listé, le compte ou sous-compte auquel elle appartient avec include_subaccounts, ou tous les comptes que vous pouvez lire auxquels elle appartient lorsqu’elle est récupérée par ID. Généralement un seul. Vide pour une vérification personnelle.Adresse figurant sur le profil de vérification.
null lorsqu’aucune adresse n’est définie.Structure juridique de l’entreprise, telle que
private_corporation ou sole_proprietorship. Les valeurs prises en charge varient selon le pays de constitution — voir Structures d’entreprise.Date de constitution de l’entreprise, au format
YYYY-MM-DD, telle qu’enregistrée pour la vérification d’entreprise. Vérifications d’entreprise uniquement ; null jusqu’à son envoi.Propriétaires de l’entreprise et avancement de la vérification propre à chacun. Vide pour les vérifications individuelles.
Propriétés
Propriétés
ID du propriétaire, préfixé par
own_. Envoyez-le dans le champ owners de Update Verification pour modifier ou supprimer le propriétaire, y compris un propriétaire ajouté dans la session hébergée.Ce que le fournisseur a rejeté lorsque la vérification du propriétaire a été renvoyée :
details (son nom, sa date de naissance ou d’autres informations ne correspondent pas à sa pièce d’identité), identity_document ou selfie. Corrigez uniquement ces éléments avec Update Verification. Vide sinon.Options disponibles : details, identity_document, selfieLes documents du propriétaire et leur avancement. Vide pour un propriétaire ajouté avec
verification_id.Propriétés
Propriétés
Raison du rejet de la soumission précédente, lorsque le fournisseur a demandé de nouveaux documents ou refusé la vérification.
Le rôle de la personne au sein de l’entreprise.Options disponibles :
ubo, director, representative, shareholderÉtat ou région de constitution de l’entreprise, tel qu’enregistré pour la vérification d’entreprise. Vérifications d’entreprise uniquement ;
null jusqu’à son envoi.Numéro sous lequel l’entreprise a été immatriculée dans son lieu de constitution, tel qu’un numéro d’enregistrement d’État aux États-Unis ou un Company Number au Royaume-Uni. Vérifications d’entreprise uniquement ; tel qu’enregistré pour la vérification d’entreprise, ou
null jusqu’à son envoi.Ce dont Whop a encore besoin avant que l’examen puisse se poursuivre, avec une exigence par entrée. Répondez avec Update Verification. Rien de la réponse n’est renvoyé. Les clés non applicables sont omises. Pour une vérification d’entreprise créée avec
documents ou owners, cela inclut les informations et documents de l’entreprise encore manquants avant qu’elle puisse être envoyée pour examen. Les documents de chaque propriétaire sont listés sous ce propriétaire.Propriétés
Propriétés
URL d’une action associée, comme terminer la vérification du caractère vivant ou consulter un paiement. Absente lorsqu’aucune action n’est disponible.
Un document qui répond à cet élément à la place de
value, comme une lettre EIN de l’IRS lorsque l’EIN n’a pas pu être rapproché. Envoyez ses pages dans files, avec ou sans value corrigée. Absent lorsque seule value est acceptée.Instruction à afficher à l’utilisateur. Reprend mot pour mot la note de l’examinateur lorsqu’il y en a une.
Les valeurs que
value peut prendre pour un élément select. Pour un élément id_document, il s’agit des types de pièces d’identité acceptés, et celui choisi détermine les emplacements documents à envoyer. Absent lorsque l’élément n’implique aucun choix.Ce qui est requis : un nom de document tel que
bank_statement, ou une clé de champ telle que ssn ou identity_document. Traitez les valeurs non reconnues selon type.Format de saisie natif facultatif pour une réponse textuelle.Options disponibles :
yes_no, yes_no_na, date, url, number, telIndique si une question avec
options accepte une seule valeur ou plusieurs valeurs.Options disponibles : single, multipleDocuments fournis avec l’exigence à titre de contexte.
Propriétés
Propriétés
Espace réservé BlurHash pour une image ou une vidéo. Null lorsqu’il n’est pas disponible ou qu’il a été supprimé par la modération.
Le type MIME du fichier d’origine, par exemple
application/pdf. Il est conservé lorsque la modération supprime le fichier.Durée de l’audio ou de la vidéo en secondes. Null lorsqu’elle n’est pas disponible ou qu’elle a été supprimée par la modération.
Hauteur de l’image ou de la vidéo en pixels. Null lorsqu’elle n’est pas disponible ou qu’elle a été supprimée par la modération.
La taille en octets que doit avoir chaque partie (sauf la dernière). Présent uniquement à la création, et uniquement pour les téléversements multiparties.
L’ID du téléversement multipartie, à renvoyer à
complete. Présent uniquement à la création, et uniquement pour les téléversements multiparties.L’URL présignée de chaque partie. Présent uniquement à la création, et uniquement pour les téléversements multiparties.
Indique si la modération a supprimé le fichier. Lorsque
true, url sert une image de remplacement. filename, size et content_type décrivent toujours le fichier d’origine.La taille du fichier en octets.
null tant que le téléversement n’est pas terminé.L’étape du cycle de téléversement à laquelle se trouve le fichier.Options disponibles :
pending, processing, ready, failedURL présignée vers laquelle envoyer (PUT) les octets du fichier. Présent uniquement à la création, et uniquement pour les téléversements en une seule partie.
Une URL pour télécharger le fichier. Les fichiers publics reçoivent une URL CDN permanente, et les fichiers privés une URL signée qui expire.
null tant que le téléversement n’est pas terminé. Lorsque la modération supprime le fichier, une URL d’image de remplacement.Les fichiers
public sont servis depuis une URL CDN non signée. Les fichiers private sont servis depuis une URL signée qui expire.Options disponibles : public, privateURL de la forme d’onde audio. Null lorsqu’elle n’est pas disponible ou qu’elle a été supprimée par la modération.
Ce qu’il faut envoyer comme réponse, afin que vous n’ayez jamais à le déduire :
files (un document, sous forme de liste de ses pages), id_document (envoyez documents avec les clés d’emplacement de la pièce d’identité que vous téléversez), text, date, phone ou select (envoyez value), text_with_files (envoyez value et éventuellement files), address (envoyez address), ou liveness (ouvrez action_url, puis envoyez value à true une fois terminé).Documents d’une vérification par téléversement de documents et leur avancement. Présent uniquement sur les vérifications individuelles créées en envoyant
documents. Les documents pending_upload n’ont pas encore été acceptés — renvoyez l’ensemble complet avec un nouvel appel à Create Verification.Propriétés
Propriétés
Raison du rejet de la soumission précédente, lorsque le fournisseur a demandé de nouveaux documents ou refusé la vérification.
URL de la session de vérification hébergée permettant à l’utilisateur d’effectuer les contrôles d’identité. Expire 7 jours après sa création.
État actuel de la vérification.
not_started avant l’existence de toute session ; pending tant qu’une session attend une action de l’utilisateur ; processing pendant l’exécution des contrôles automatisés du fournisseur sur une nouvelle soumission ; action_required lorsque requested_information attend des réponses ; manual_review pendant l’examen d’informations déjà envoyées — une réponse d’audit, ou un document détenu par le fournisseur de versements — rien à soumettre, généralement terminé sous 3 jours ouvrés ; approved en cas de succès ; rejected en cas d’échec. Appelez à nouveau Create Verification pour démarrer une nouvelle session.Options disponibles : not_started, pending, processing, manual_review, approved, rejected, action_requiredVerification

