> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Traiter les RFI de vérification

> Répondez lorsque Whop a besoin d'informations supplémentaires — un document, un numéro fiscal ou un détail sur l'entreprise.

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](#every-requirement) 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

```bash cURL theme={null}
curl "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY"
```

Lorsque des RFI sont en attente, la vérification ressemble à ceci :

```json theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "action_required",
  "requested_information": [
    {
      "id": "inrqi_xxxxxxxxxxxxx",
      "requirement": "date_of_birth",
      "type": "date",
      "label": "Date of Birth"
    },
    {
      "id": "inrqi_yyyyyyyyyyyyy",
      "requirement": "business_structure",
      "type": "select",
      "label": "Business Structure",
      "options": ["single_member_llc", "multi_member_llc", "sole_proprietorship", "private_corporation"]
    },
    {
      "id": "inrqi_zzzzzzzzzzzzz",
      "requirement": "bank_statement",
      "type": "files",
      "label": "Bank Statement for account ending in 4242"
    }
  ]
}
```

### Champs d'un élément

| Champ | Description |
| - | - |
| `id` | L'identifiant de l'élément, préfixé par `inrqi_` — incluez-le lorsque vous soumettez une réponse |
| `requirement` | Ce dont Whop a besoin, comme `ssn` ou `bank_statement` — voir [toutes les exigences](#every-requirement) |
| `type` | Ce qu'il faut renvoyer : `files`, `id_document`, `text`, `date`, `phone`, `select` ou `address` |
| `label` | Ce qu'il faut afficher à votre utilisateur. Contient la note de l'examinateur lorsqu'il y en a une |
| `options` | Valeurs autorisées pour un élément `select`, ou types de pièces d'identité acceptés pour un élément `id_document` |
| `optional` | Apparaît avec la valeur `true` lorsque l'utilisateur peut ignorer l'élément |
| `errors` | Présent après une réponse refusée, chaque entrée comportant un `code` stable et une `reason` lisible |

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 :

| `type` de l'élément | Payload de réponse |
| - | - |
| `files` | `files` — un document, sous forme de liste de ses pages |
| `id_document` | `documents` — les clés d'emplacement de la pièce d'identité que vous téléversez |
| `text`, `date`, `phone`, `select` | `value` |
| `address` | objet `address` |

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 :

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "1990-01-15" },
      { "id": "inrqi_yyyyyyyyyyyyy", "value": "single_member_llc" }
    ]
  }'
```

### 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` :

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_xxxxxxxxxxxxx",
        "address": {
          "line1": "123 Spring Street",
          "city": "New York",
          "state": "NY",
          "postal_code": "10012",
          "country": "US"
        }
      }
    ]
  }'
```

Les boîtes postales ne sont pas acceptées pour les adresses personnelles ou professionnelles.

### Documents

[Téléversez d'abord le fichier](https://docs.whop.com/fr/developer/guides/upload-files.md), puis transmettez son ID dans `files` :

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_zzzzzzzzzzzzz", "files": ["file_xxxxxxxxxxxxx"] }
    ]
  }'
```

Chaque entrée accepte soit un ID `file_` issu du [flux de téléversement](https://docs.whop.com/fr/developer/guides/upload-files.md), 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 :

```json theme={null}
{ "id": "inrqi_aaa", "requirement": "business_verification_document", "type": "files",
  "label": "Company Verification Document" }
```

```json theme={null}
{ "id": "inrqi_aaa", "files": ["file_page1xxxxxx", "file_page2xxxxxx"] }
```

#### 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](https://docs.whop.com/fr/api-reference/verifications/create-verification.md) :

```json theme={null}
{
  "id": "inrqi_bbb",
  "requirement": "identity_document",
  "type": "id_document",
  "label": "Identity Document",
  "options": ["ID_CARD", "DRIVERS", "RESIDENCE_PERMIT", "PASSPORT"]
}
```

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      {
        "id": "inrqi_bbb",
        "documents": {
          "drivers_front": "file_frontxxxxxxx",
          "drivers_back": "file_backxxxxxxxx"
        }
      }
    ]
  }'
```

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 :

| Type de pièce | Emplacements |
| - | - |
| `PASSPORT` | `passport_front` |
| `ID_CARD` | `id_card_front`, `id_card_back` |
| `DRIVERS` | `drivers_front`, `drivers_back` |
| `RESIDENCE_PERMIT` | `residence_permit_front`, `residence_permit_back` |

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 :

```bash cURL theme={null}
curl -X PATCH https://api.whop.com/api/v1/verifications/idpf_xxxxxxxxxxxxx \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "requested_information": [
      { "id": "inrqi_xxxxxxxxxxxxx", "value": "123-45-6789" }
    ]
  }'
```

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

```json theme={null}
{
  "id": "inrqi_xxxxxxxxxxxxx",
  "requirement": "business_website",
  "type": "text",
  "label": "Business website or social profile",
  "errors": [
    {
      "code": "invalid_url_website_inaccessible",
      "reason": "The website provided could not be reached."
    }
  ]
}
```

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 :

| Code | Signification |
| - | - |
| `bad_proof_of_identity` | Whop n'accepte pas la preuve d'identité — fournissez une pièce d'identité officielle avec photo |
| `expiration_date` | Le document a expiré |
| `unsatisfactory_photos` | Trop flou pour être lu |
| `problematic_applicant_data` | Les informations soumises ne correspondent pas au document |
| `screenshots` | L'utilisateur a téléversé une capture d'écran au lieu d'une photo du document |
| `graphic_editor` | Le document semble avoir été modifié |
| `digital_document` | L'utilisateur a téléversé une copie numérique. Fournissez une photo du document physique |
| `document_damaged` | Endommagé ou partiellement illisible |
| `document_page_missing` | Une page est manquante |
| `document_missing` | Le document n'a pas été reçu |
| `not_document` | Le fichier n'est pas un document |
| `id_invalid` | Le document d'identité n'est pas valide |
| `incompatible_language` | Langue non prise en charge. Fournissez une traduction certifiée |
| `bad_selfie` | Le selfie n'était pas net |
| `bad_face_matching` | Le selfie ne correspond pas à la photo du document |
| `bad_proof_of_address` | Ce n'est pas un justificatif de domicile accepté |
| `wrong_address` | L'adresse ne correspond pas au document |
| `incorrect_social_number` | Le numéro d'identification fiscale ne correspond pas au document |
| `company_incorrect_data` | Les informations du compte ne correspondent pas au document d'immatriculation |
| `company_data_mismatch` | Les informations du compte ne correspondent pas aux registres de Whop |
| `company_inactive_entity` | Le compte n'est pas répertorié comme actif dans le registre |
| `additional_document_required` | Whop a besoin d'un autre document |
| `more_documents_required` | Whop a besoin de documents supplémentaires |
| `db_data_mismatch` | Les informations soumises ne correspondent pas aux registres officiels |
| `spam` | Whop n'a pas pu traiter la soumission |

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

| Exigence | Type | Ce qu'il faut soumettre |
| - | - | - |
| `first_name` | `text` | Prénom légal, avec majuscule (`Jane`) |
| `last_name` | `text` | Nom de famille légal, avec majuscule (`Doe`) |
| `creator_legal_name` | `text` | Nom légal complet tel qu'il figure sur les documents officiels |
| `date_of_birth` | `date` | `YYYY-MM-DD` |
| `email` | `text` | Adresse e-mail |
| `creator_email_address` | `text` | Une adresse e-mail à laquelle Whop peut joindre l'utilisateur |
| `phone_number` | `phone` | Format E.164 avec indicatif pays (`+12125550123`) |
| `personal_address` | `address` | Adresse de résidence actuelle — pas de boîte postale |
| `occupation` | `text` | Code Standard Occupational Classification (`15-1132`), ou `SELFEMP`, `STUDENT`, `RETIRED`, `UNEMPLO`, `OTHERXX` |
| `annual_salary` | `text` | Revenu annuel approximatif en dollars américains, chiffres uniquement |

### Numéros fiscaux et d'identification officiels

Whop remplace ces valeurs par des jetons sécurisés pendant le transit — voir [valeurs sensibles](#sensitive-values).

| Exigence | Type | Ce qu'il faut soumettre |
| - | - | - |
| `ssn` | `text` | Numéro de sécurité sociale américain (Social Security Number), `XXX-XX-XXXX` |
| `ein` | `text` | Numéro d'identification d'employeur américain (Employer Identification Number), `XX-XXXXXXX` |
| `company_tax_id` | `text` | Numéro fiscal du compte au format du pays émetteur |
| `personal_id_number` | `text` | Numéro d'identification personnel officiel (passeport, permis de conduire, carte d'identité nationale) |
| `personal_id_number_country` | `select` | Pays ayant émis le numéro d'identification — choisissez parmi les `options` |
| `country_of_issue` | `text` | Code pays à deux lettres du pays émetteur (`US`) |

### Documents d'identité

| Exigence | Type | Ce qu'il faut soumettre |
| - | - | - |
| `identity_document` | `id_document` | Pièce d'identité officielle avec photo. Envoyez `documents` avec les clés d'emplacement de la pièce téléversée par l'utilisateur |
| `selfie` | `files` | Photo de l'utilisateur tenant sa pièce d'identité |

### Informations sur l'entreprise

| Exigence | Type | Ce qu'il faut soumettre |
| - | - | - |
| `business_name` | `text` | La raison sociale enregistrée de l'entreprise |
| `trade_name` | `text` | Nom commercial public s'il diffère de la raison sociale (doing business as) |
| `company_title` | `text` | Le nom du compte |
| `business_structure` | `select` | Structure juridique — l'une des `options`, par ex. `single_member_llc`, `sole_proprietorship`, `private_corporation` |
| `account_type` | `select` | `individual`, `company` ou `non_profit` |
| `business_representative_title` | `select` | Fonction du représentant — l'une des `options`, par ex. `CEO`, `Owner`, `Manager` |
| `industry_type` | `text` | Secteur d'activité de l'entreprise |
| `business_description` | `text` | 100 à 1000 caractères : ce qui est vendu, ce que les clients reçoivent après paiement et où ils y accèdent |
| `product_description` | `text` | Le produit ou service vendu |
| `business_phone_number` | `phone` | Format E.164 avec indicatif pays |
| `business_address` | `address` | Adresse enregistrée de l'entreprise — pas de boîte postale |
| `business_website` | `text` | URL du site web de l'entreprise |
| `social_media_or_website` | `text` | Site web, ou profil public sur un réseau social représentatif de ce qui est vendu |
| `store_page_url` | `text` | Lien vers la boutique ou la page produit |
| `expected_monthly_volume` | `text` | Volume de traitement mensuel prévu en dollars américains, chiffres uniquement |
| `account_purpose` | `text` | Usage principal du compte |

### Documents de l'entreprise

| Exigence | Type | Ce qu'il faut soumettre |
| - | - | - |
| `business_verification_document` | `files` | Document confirmant l'identité juridique du compte : lettre 147C de l'Internal Revenue Service (IRS), formulaire SS-4 ou lettre d'assistance relative à l'Employer Identification Number (EIN) |
| `business_incorporation_papers` | `files` | Documents officiels de constitution |
| `ownership_structure` | `files` | Documents indiquant qui détient l'entreprise |
| `processing_statements` | `files` | Relevés d'un précédent prestataire de paiement montrant l'historique de traitement — pas de relevés bancaires |
| `proof_of_fulfillment` | `files` | Capture d'écran, enregistrement ou fichier montrant ce que les clients reçoivent après l'achat |
| `proof_of_funnel` | `text` ou `files` | D'où viennent les clients — un compte sur un réseau social, un site web ou une page de destination |

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

| Exigence | Type | Ce qu'il faut soumettre |
| - | - | - |
| `bank_statement` | `files` | Relevé bancaire récent du compte de versement |
| `paper_check` | `files` | Chèque papier annulé |
| `wallet_screenshot` | `files` | Capture d'écran d'un portefeuille ou du solde d'un compte |
| `government_id` | `files` | Pièce d'identité officielle |
| `proof_of_address` | `files` | Justificatif de domicile émis au cours des 3 derniers mois |
| `utility_bill` | `files` | Facture de services publics émise au cours des 3 derniers mois |
| `insurance_card` | `files` | Carte d'assurance émise au cours des 3 derniers mois |
| `company_documents` | `files` | Documents du compte ou de l'entité |

### Questions d'examen

| Exigence | Type | Ce qu'il faut soumettre |
| - | - | - |
| `anything_else` | `text` ou `files` | Toute autre information que l'équipe d'examen devrait connaître |
| `accept_tos` | `text` | Confirmation que l'utilisateur accepte les conditions d'utilisation |
| `signature` | `files` | Image de signature pour un accord |


## Related topics

- [Verifications](https://docs.whop.com/fr/elements/latest/verifications/overview.md)
- [Vérification](https://docs.whop.com/fr/api-reference/legacy/verifications/verification.md)
- [Vérifier l'identité des utilisateurs avec le KYC](https://docs.whop.com/fr/developer/verification/overview.md)
