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

# Identiteit van gebruikers verifiëren met KYC

> Verifieer de identiteit van je gebruikers voordat ze uitbetalingen kunnen ontvangen. Eén API-aanroep start de Know Your Customer-verificatie (KYC), en Whop regelt de rest.

## Hoe het werkt

**1. Start een verificatie**

Roep `POST /api/v1/verifications` aan met het account dat je wilt verifiëren. Je krijgt een `session_url` terug.

**2. Stuur de gebruiker door om KYC te voltooien**

Stuur je gebruiker door naar de `session_url`. Daar uploadt de gebruiker een identiteitsbewijs, maakt een selfie en verifieert zijn identiteit op een gehoste pagina. Je hoeft hiervoor zelf geen UI te bouwen.

**3. Luister naar het resultaat**

Abonneer je op de webhook `identity_profile.updated` — die wordt geactiveerd bij elke wijziging van het profiel (goedgekeurd, afgewezen, actie vereist, of een beoordeling die wordt geopend of afgerond). De webhook vertelt je *welk* profiel is gewijzigd, niet de nieuwe status ervan, dus roep `GET /api/v1/verifications?account_id={biz_ tag}` aan om de actuele status en de geverifieerde identiteitsgegevens te lezen.

## Snel voorbeeld

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "pending",
  "session_url": "https://in.sumsub.com/websdk/p/sbx_xxxxxxxxxxxxx",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

> [!NOTE]
>
> Je hebt een Account API-sleutel met de scope `identity:write` nodig. Zie [Auth & API-sleutels](https://docs.whop.com/nl/developer/guides/auth-scoping.md) voor de soorten inloggegevens en hoe je hun scope instelt. Ga naar je [dashboard](https://whop.com/dashboard) → Settings → API Keys om er een aan te maken.

## Het identiteitsverificatieformulier vooraf invullen

Geef identiteitsvelden door om je gebruiker stappen te besparen. Deze vullen het verificatieformulier vooraf in, zodat de gebruiker naam en adres niet opnieuw hoeft te typen:

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "kind": "individual",
    "first_name": "Jane",
    "last_name": "Doe",
    "date_of_birth": "1995-01-15",
    "country": "US",
    "tax_identification_number": "123-45-6789",
    "address": {
      "line1": "123 Main St",
      "city": "San Francisco",
      "state": "CA",
      "postal_code": "94105"
    }
  }'
```

> [!NOTE]
>
> `tax_identification_number` is het fiscale identificatienummer van de persoon — het SSN voor
> personen in de VS — en is **verplicht wanneer `country` `US` is**: zonder dit nummer kan het
> uitbetalingsaccount niet worden aangemaakt. Stuur het ongewijzigd mee. Het wordt tijdens de
> overdracht getokeniseerd en de ruwe waarde wordt nooit opgeslagen in de systemen van Whop.

> [!WARNING]
>
> Whop kan geen gebruikers ondersteunen in een [land of regio onder sancties](https://docs.whop.com/nl/trust-and-safety/trust-safety-overview/sanctioned-countries.md).
> Het verzoek mislukt met een `400` en de foutcode `address_country_sanctioned`.

## Een bestaande verificatie hergebruiken

Heb je deze persoon al met Sumsub geverifieerd, stuur dan diens share token in plaats van de persoon
een tweede keer door KYC te laten gaan. Whop importeert de identiteit die je Sumsub-account heeft bevestigd en
toetst die aan de eigen vereisten van Whop:

```bash cURL theme={null}
curl -X POST "https://api.whop.com/api/v1/verifications?account_id=biz_xxxxxxxxxxxxx" \
  -H "Authorization: Bearer $WHOP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind": "individual", "share_token": "_act-sbx-jwt-eyJhbGciOiJub25l"}'
```

```json Response theme={null}
{
  "id": "idpf_xxxxxxxxxxxxx",
  "kind": "individual",
  "status": "approved",
  "first_name": "Jane",
  "last_name": "Doe",
  "created_at": "2026-06-03T22:15:00Z",
  "updated_at": "2026-06-03T22:15:00Z"
}
```

**1. Spreek Reusable KYC af met Whop**

Sumsub geeft alleen aanvragergegevens vrij tussen clients die een Reusable KYC-overeenkomst hebben. Whop
geeft je het client-ID om mee te delen zodra die overeenkomst er is.

**2. Genereer een share token voor de aanvrager**

Roep `POST https://api.sumsub.com/resources/accessTokens/shareToken` aan op je eigen Sumsub-account
met het ID van de aanvrager en het client-ID van Whop als `forClientId`.

**3. Stuur het naar Whop**

Geef het token door als `share_token`. Elk token werkt één keer.

De response vertelt je waar het is beland. `approved` betekent dat je verificatie alles dekt wat Whop
nodig heeft en dat er niets meer te doen is. `pending` met een `session_url` betekent dat ze een deel dekt —
stuur de gebruiker naar die URL om alleen af te ronden wat nog ontbreekt. Whop weigert met een `400` een token waarvan de gegevens
geen enkele vereiste dekken.

> [!NOTE]
>
> `share_token` kan niet worden gecombineerd met `documents` of `document_type` — elk daarvan is een volledig
> alternatief voor de gehoste flow.

## Twee soorten verificatie

| Type | `kind` | Wat wordt geverifieerd | Wanneer te gebruiken |
| - | - | - | - |
| Individu (KYC) | `individual` | De identiteit van een persoon | Gebruiker wil geld opnemen |
| Bedrijf (KYB) | `business` | Een bedrijfsentiteit | Account moet zijn rechtspersoon verifiëren |

Een account kan van elk één hebben — een individuele KYC en een zakelijke KYB.

## Volgende stappen

> [card] [Status controleren](https://docs.whop.com/nl/developer/verification/retrieve.md)
>
> Controleer de verificatiestatus en lees geverifieerde identiteitsgegevens.

> [card] [RFI's afhandelen](https://docs.whop.com/nl/developer/verification/rfis.md)
>
> Reageer wanneer Whop aanvullende informatie nodig heeft, zoals een bankafschrift.

> [card] [Bijwerken & verwijderen](https://docs.whop.com/nl/developer/verification/manage.md)
>
> Werk identiteitsvelden bij of verwijder een verificatie.

> [card] [API-referentie](https://docs.whop.com/nl/api-reference/verifications/verification)
>
> Volledige veldreferentie voor het verificatieobject.


## Related topics

- [Geautoriseerde gebruiker](https://docs.whop.com/nl/api-reference/legacy/authorized-users/authorized-user.md)
- [Verificatie](https://docs.whop.com/nl/api-reference/legacy/verifications/verification.md)
- [Uitbetalingen voor subaccounts inschakelen](https://docs.whop.com/nl/developer/platforms/render-payout-portal.md)
