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

# Documents d'identité

> Les documents d'identité acceptés par l'API, et les clés de fichier exactes à envoyer pour chacun d'eux.

Vérifiez une personne entièrement via l'API en envoyant les photos de son document d'identité dans la requête [Créer une vérification](https://docs.whop.com/fr/api-reference/verifications/create-verification.md). Pas de session hébergée, pas d'appels supplémentaires : un seul `POST`, puis interrogez l'API pour obtenir le verdict.

## Quels fichiers envoyer

Choisissez le `document_type` qui correspond au document photographié. Il détermine exactement les clés que l'objet `documents` doit contenir — ni plus, ni moins.

| `document_type` | Clés `documents` requises |
| - | - |
| `id_card` | `id_card_front`, `id_card_back`, `selfie` |
| `drivers` | `drivers_front`, `drivers_back`, `selfie` |
| `residence_permit` | `residence_permit_front`, `residence_permit_back`, `selfie` |
| `passport` | `passport_front`, `selfie` |

Chaque valeur correspond aux octets bruts du fichier, encodés en base64 :

```python theme={null}
import base64

def b64(path):
    with open(path, "rb") as f:
        return base64.b64encode(f.read()).decode()
```

## Règles relatives aux fichiers

* Joint Photographic Experts Group (JPEG), Portable Network Graphics (PNG) ou PDF. Whop détecte le type à partir des octets réels du fichier : l'extension n'a donc pas d'importance.
* Le `selfie` doit être une photo JPEG ou PNG du visage de la personne.
* 5 Mo maximum par fichier, mesurés avant l'encodage.
* Envoyez l'ensemble complet dans une seule requête. Un fichier manquant, trop volumineux ou illisible fait échouer toute la requête avec une erreur qui nomme la clé exacte — corrigez ce fichier et renvoyez la même requête. Rien n'est jamais soumis partiellement.

## Exemple complet

```bash theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_XXXXXXXX" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"first_name\": \"Jane\",
    \"last_name\": \"Doe\",
    \"date_of_birth\": \"1990-01-01\",
    \"country\": \"US\",
    \"phone\": \"+15551234567\",
    \"tax_identification_number\": \"123456789\",
    \"address\": { \"line1\": \"123 Main St\", \"city\": \"Austin\", \"state\": \"TX\", \"postal_code\": \"73301\" },
    \"business_website\": \"https://example.com\",
    \"document_type\": \"drivers\",
    \"documents\": {
      \"drivers_front\": \"$(base64 -i front.jpg)\",
      \"drivers_back\": \"$(base64 -i back.jpg)\",
      \"selfie\": \"$(base64 -i selfie.jpg)\"
    }
  }"
```

Un `201` signifie que Whop a accepté tous les documents et lancé l'examen — le champ `required_documents` de la réponse liste chaque clé comme `submitted`. Interrogez [Récupérer une vérification](https://docs.whop.com/fr/api-reference/verifications/retrieve-verification.md) jusqu'à ce que `status` devienne `approved` ou `rejected`.

> [!NOTE]
>
> `business_website` est facultatif. S'il est omis, la page whop.com du compte est utilisée pour la configuration des versements. Si vous en envoyez un, il doit s'agir d'un site externe ou d'un lien vers un réseau social. Les pages de boutique Whop sont refusées.

## Si Whop refuse un document

Lorsque l'examinateur ne peut pas accepter une photo, `status` repasse à `action_required` et les clés refusées apparaissent dans `required_documents` avec le statut `pending_upload` et une `rejection_reason`. Renvoyez la même requête Create Verification avec une meilleure photo — l'examen reprend automatiquement.

## Couverture par pays

Whop accepte `id_card`, `drivers` et `passport` pour les personnes de la plupart des pays. Le tableau ci-dessous liste les exceptions. Pour un pays de ce tableau, seules les valeurs listées fonctionnent. Toute autre valeur passe par le processus de refus décrit précédemment.

| Pays | Valeurs `document_type` acceptées |
| - | - |
| `AD` | `drivers`, `residence_permit`, `passport` |
| `AI` | `drivers`, `passport` |
| `AQ` | `passport` |
| `AS` | `drivers`, `passport` |
| `CC` | `id_card`, `passport` |
| `CK` | `drivers`, `passport` |
| `CX` | `drivers`, `passport` |
| `EH` | `passport` |
| `ER` | `id_card`, `passport` |
| `FK` | `passport` |
| `FM` | `drivers`, `residence_permit`, `passport` |
| `FO` | `drivers`, `passport` |
| `GF` | `id_card`, `residence_permit`, `passport` |
| `GL` | `drivers`, `passport` |
| `HM` | `passport` |
| `KY` | `drivers`, `passport` |
| `MS` | `drivers`, `residence_permit`, `passport` |
| `NF` | `passport` |
| `PM` | `id_card`, `passport` |
| `SH` | `passport` |
| `SJ` | `passport` |
| `TF` | `passport` |
| `TK` | `drivers`, `passport` |
| `TV` | `drivers`, `passport` |
| `VA` | `passport` |
| `WF` | `id_card`, `passport` |
| `YT` | `id_card`, `passport` |

Whop accepte aussi `residence_permit` dans la plupart des pays, mais sa couverture est plus restreinte. En plus du tableau précédent, Whop **ne** l'accepte **pas** pour les personnes situées dans :

`AG`, `AW`, `BB`, `BF`, `BI`, `BL`, `BZ`, `CV`, `CW`, `DM`, `GG`, `GI`, `GN`, `GS`, `GU`, `GY`, `IM`, `IO`, `JE`, `KI`, `KM`, `LC`, `LR`, `MF`, `ML`, `MP`, `MQ`, `MU`, `NC`, `NR`, `NU`, `NZ`, `PF`, `PG`, `PN`, `PR`, `PS`, `PW`, `SB`, `SC`, `SM`, `SR`, `ST`, `SX`, `SY`, `SZ`, `TC`, `TL`, `TO`, `VC`, `VI`, `WS`

Whop ne propose pas la vérification d'identité aux personnes situées dans ces pays et refuse tous les types de documents :

`AF` (Afghanistan), `BY` (Biélorussie), `CU` (Cuba), `HT` (Haïti), `IQ` (Irak), `IR` (Iran), `KP` (Corée du Nord), `LY` (Libye), `MM` (Myanmar), `MZ` (Mozambique), `RU` (Russie), `SD` (Soudan), `SO` (Somalie), `SS` (Soudan du Sud)

> [!NOTE]
>
> Ce tableau reflète la configuration de vérification de Whop en juillet 2026. L'acceptation par pays est appliquée lors de l'examen : un type de document non valide pour le pays de la personne échoue donc avec une `rejection_reason` plutôt qu'avec une erreur immédiate.


## Related topics

- [Traiter les RFI de vérification](https://docs.whop.com/fr/developer/verification/rfis.md)
- [Versions de l'API](https://docs.whop.com/fr/developer/api/versioning.md)
- [Profil d'identité](https://docs.whop.com/fr/api-reference/legacy/identity-profiles/identity-profile.md)
