requested_information de la vérification. Le status de la vérification reste action_required jusqu’à ce que l’utilisateur ait répondu à chaque élément.
Chaque élément représente une chose à collecter, à laquelle vous répondez par une seule écriture. Un requirement nomme ce qui est demandé, un type d’entrée vous indique comment le collecter, et un label fournit le texte destiné à l’utilisateur. La réponse omet les clés qui ne s’appliquent pas à un élément. Consultez toutes les exigences pour le catalogue complet.
Fonctionnement des RFI
1
Des informations sont demandées
Whop signale qu’un élément est nécessaire. Le statut de la vérification passe à
action_required et un webhook identity_profile.updated se déclenche. (identity_profile.needs_action se déclenche aussi pour cette transition, mais identity_profile.updated est l’événement générique qui couvre chaque changement d’état — abonnez-vous-y et récupérez à nouveau la vérification pour voir ce qui reste en attente.)2
Vous lisez les éléments
Appelez
GET /api/v1/verifications?account_id={biz_ tag}. Le tableau requested_information de chaque vérification liste ce qui est demandé et le type de réponse à collecter.3
Vous collectez et soumettez
Obtenez les informations auprès de votre utilisateur et renvoyez-les via
PATCH /api/v1/verifications/{id} avec un tableau requested_information. Whop achemine chaque réponse au bon endroit.4
L'examen se poursuit
Les éléments ayant reçu une réponse quittent le tableau. Une fois celui-ci vide, la vérification passe à
processing pendant l’examen des réponses — il n’y a rien à soumettre dans cet état. Elle aboutit à approved, ou à manual_review si un examen de conformité est ouvert. Si une réponse est refusée, l’élément revient à action_required avec des errors qui en expliquent la raison. Soumettez-le à nouveau.Lire les RFI
cURL
Champs d’un élément
La réponse ne renvoie que les clés qui s’appliquent à un élément : un élément ne contient donc jamais de tableau vide ni de
null que vous devriez vérifier.
La réponse ne renvoie que les éléments ouverts — les éléments ayant reçu une réponse quittent le tableau, donc tout ce qui y figure est encore dû par l’utilisateur. La vérification reste action_required jusqu’à ce que le tableau soit vide.
Répondre aux RFI
Envoyez unPATCH sur l’identifiant idpf_ de la vérification avec un tableau requested_information. Chaque entrée nécessite l’id de l’élément et exactement un payload de réponse correspondant au type de l’élément :
La réponse ne renvoie rien d’autre de l’élément — ni catégories ni types de documents. L’
id de l’élément indique à Whop à quoi correspond la réponse.
Vous pouvez répondre à plusieurs éléments en une seule requête :
cURL
Valeurs de texte, de date, de téléphone et de sélection
Transmettez la réponse dansvalue. Les dates utilisent le format YYYY-MM-DD, les numéros de téléphone le format E.164 (+12125550123), et les valeurs de sélection doivent faire partie des options de l’élément.
Adresses
Transmettez un objetaddress :
cURL
Documents
Téléversez d’abord le fichier, puis transmettez son ID dansfiles :
cURL
file_ issu du flux de téléversement, soit un direct_upload_id issu d’un téléversement direct. Les documents doivent être des fichiers Joint Photographic Experts Group (JPEG), Portable Network Graphics (PNG) ou PDF de 32 Mo maximum. Un document d’une page est une liste d’un seul élément — il n’existe pas de champ distinct pour un fichier unique.
Le requirement nomme le document dont Whop a besoin, et Whop s’occupe du reste — vous n’indiquez jamais quel type de document vous avez téléversé.
Documents de plusieurs pages
Un document de plusieurs pages se place dans la même listefiles, dans l’ordre des pages :
Documents d’identité
Un élémentid_document demande de quelle pièce d’identité il s’agit. Il contient des options listant les types de pièces acceptés par l’examen, et la réponse nomme chaque emplacement avec les mêmes clés que celles acceptées par Créer une vérification :
cURL
Whop refuse les emplacements mélangés provenant de deux documents ou un document incomplet avant de stocker quoi que ce soit. Les
options de l’élément indiquent quels types de pièces cet examen accepte.
Si un élément de fichier n’a pas d’options, il ne nécessite pas de value.
Valeurs sensibles
Soumettez les numéros fiscaux et les numéros d’identification officiels (ssn, ein, company_tax_id, personal_id_number) comme n’importe quelle autre valeur. Whop les remplace par des jetons sécurisés pendant le transit et ne stocke que la référence sécurisée :
cURL
value_type: "vault_token".
Réponses refusées
Si Whop refuse une réponse soumise, l’élément revient dansrequested_information avec errors renseigné :
reason à votre utilisateur et utilisez code pour adapter votre logique si nécessaire. Traitez les codes non reconnus comme un refus générique.
Corrigez le problème sous-jacent et soumettez à nouveau avec le même id d’élément. La vérification reste action_required jusqu’à ce que Whop accepte la réponse corrigée.
Codes de refus de documents
Lorsque Whop refuse un document téléversé,code indique ce qui n’allait pas. Voici les codes que vous pouvez recevoir :
Chaque code ci-dessus décrit un problème corrigeable dans le téléversement. Un refus que Whop ne peut attribuer à aucun d’eux ne renvoie aucune
errors plutôt qu’un code inexploitable. Gérez toujours le cas d’un élément sans errors, et privilégiez reason pour le texte destiné à l’utilisateur.
Toutes les exigences
Lerequirement de chaque élément correspond à l’une des valeurs ci-dessous.
Informations personnelles
Numéros fiscaux et d’identification officiels
Whop remplace ces valeurs par des jetons sécurisés pendant le transit — voir valeurs sensibles.Documents d’identité
Informations sur l’entreprise
Documents de l’entreprise
Documents du compte de versement
Un document demandé pour vérifier une destination de versement nomme le document lui-même. Téléversez un seul fichier — lelabel indique à votre utilisateur à quel compte il se rapporte.

