Skip to main content
Whop émet une demande d’informations (RFI, Request for Information) lorsqu’il a besoin d’un élément supplémentaire de la part d’un utilisateur — un document, un numéro fiscal ou un détail sur l’entreprise. Chaque RFI ouverte apparaît dans le tableau 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
Lorsque des RFI sont en attente, la vérification ressemble à ceci :

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 un PATCH 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 dans value. 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 objet address :
cURL
Les boîtes postales ne sont pas acceptées pour les adresses personnelles ou professionnelles.

Documents

Téléversez d’abord le fichier, puis transmettez son ID dans files :
cURL
Chaque entrée accepte soit un ID 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 liste files, dans l’ordre des pages :

Documents d’identité

Un élément id_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
La clé nomme à la fois le document et le côté : il n’y a donc pas de champ distinct pour indiquer quelle pièce d’identité représente le document — Whop le déduit des clés. Envoyez tous les emplacements de la pièce que vous téléversez : 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
Si vous tokenisez déjà les valeurs vous-même (Basis Theory), transmettez plutôt l’ID du jeton avec value_type: "vault_token".

Réponses refusées

Si Whop refuse une réponse soumise, l’élément revient dans requested_information avec errors renseigné :
Affichez 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

Le requirement 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 — le label indique à votre utilisateur à quel compte il se rapporte.

Questions d’examen