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

# Identiteitsdocumenten

> Welke identiteitsdocumenten de API accepteert, en de exacte bestandssleutels die je per document moet versturen.

Verifieer een persoon volledig via de API door foto's van diens identiteitsdocument mee te sturen in het verzoek [Create Verification](https://docs.whop.com/nl/api-reference/verifications/create-verification.md). Geen gehoste sessie, geen vervolgaanroepen: één `POST`, en daarna pollen voor het oordeel.

## Welke bestanden je verstuurt

Kies het `document_type` dat overeenkomt met het document op de foto. Dat bepaalt precies welke sleutels het object `documents` moet bevatten — niet meer en niet minder.

| `document_type` | Verplichte `documents`-sleutels |
| - | - |
| `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` |

Elke waarde bestaat uit de ruwe bytes van het bestand, base64-gecodeerd:

```python theme={null}
import base64

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

## Regels voor bestanden

* Joint Photographic Experts Group (JPEG), Portable Network Graphics (PNG) of PDF. Whop bepaalt het type aan de hand van de werkelijke bytes van het bestand, dus de extensie maakt niet uit.
* De `selfie` moet een JPEG- of PNG-foto van het gezicht van de persoon zijn.
* Maximaal 5 MB per bestand, gemeten vóór het coderen.
* Verstuur de volledige set in één verzoek. Een ontbrekend, te groot of onleesbaar bestand laat het hele verzoek mislukken met een fout die de exacte sleutel noemt — corrigeer dat bestand en verstuur hetzelfde verzoek opnieuw. Er wordt nooit iets gedeeltelijk ingediend.

## Volledig voorbeeld

```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)\"
    }
  }"
```

Een `201` betekent dat Whop elk document heeft geaccepteerd en de beoordeling is gestart — `required_documents` in de response vermeldt elke sleutel als `submitted`. Poll [Retrieve Verification](https://docs.whop.com/nl/api-reference/verifications/retrieve-verification.md) totdat `status` `approved` of `rejected` wordt.

> [!NOTE]
>
> `business_website` is optioneel. Als je het weglaat, wordt de whop.com-pagina van het account gebruikt voor de configuratie van uitbetalingen. Als je het wel meestuurt, moet het een externe site of een link naar sociale media zijn. Whop-winkelpagina's worden geweigerd.

## Als Whop een document weigert

Als de beoordelaar een foto niet kan accepteren, keert `status` terug naar `action_required` en verschijnen de geweigerde sleutels in `required_documents` als `pending_upload` met een `rejection_reason`. Verstuur hetzelfde Create Verification-verzoek opnieuw met een betere foto — de beoordeling wordt automatisch hervat.

## Dekking per land

Whop accepteert `id_card`, `drivers` en `passport` voor mensen in de meeste landen. De onderstaande tabel somt de uitzonderingen op. Voor een land in deze tabel werken alleen de vermelde waarden. Al het andere komt terug via de hierboven beschreven weigeringsflow.

| Land | Geaccepteerde `document_type`-waarden |
| - | - |
| `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 accepteert ook `residence_permit` in de meeste landen, maar de dekking is beperkter. Naast de vorige tabel accepteert Whop het **niet** voor mensen in:

`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 biedt geen identiteitsverificatie aan voor mensen in deze landen en weigert elk documenttype:

`AF` (Afghanistan), `BY` (Belarus), `CU` (Cuba), `HT` (Haïti), `IQ` (Irak), `IR` (Iran), `KP` (Noord-Korea), `LY` (Libië), `MM` (Myanmar), `MZ` (Mozambique), `RU` (Rusland), `SD` (Soedan), `SO` (Somalië), `SS` (Zuid-Soedan)

> [!NOTE]
>
> Deze tabel geeft de verificatieconfiguratie van Whop weer per juli 2026. De acceptatie per land wordt toegepast tijdens de beoordeling, dus een documenttype dat niet geldig is voor het land van de persoon mislukt met een `rejection_reason` in plaats van met een fout vooraf.


## Related topics

- [RFI's voor verificatie afhandelen](https://docs.whop.com/nl/developer/verification/rfis.md)
- [API-versies](https://docs.whop.com/nl/developer/api/versioning.md)
