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

# Verificatie

> Een sessie voor identiteitsverificatie die wordt gebruikt om de identiteit van een persoon of entiteit te bevestigen zodat het uitbetalingsaccount in aanmerking komt.

> [!NOTE]
>
> Deze resource heeft een opvolger in de [Whop API](https://docs.whop.com/nl/api-reference/legacy/verifications/verification.md), de API met versies waarop nieuwe integraties moeten bouwen. Deze pagina blijft volledig ondersteund.

Een Verificatie begeleidt een persoon of bedrijf door de identiteitscontroles die nodig zijn om uitbetalingen op een account te ontvangen. Personen doorlopen Know Your Customer-controles (KYC) en bedrijven doorlopen Know Your Business-controles (KYB). Maak bijvoorbeeld een Verificatie aan vóór de eerste uitbetaling van een gebruiker. Je kunt hun naam en adres vooraf invullen, zodat ze het gehoste formulier kunnen voltooien zonder een eigen verificatie-UI. Gebruik later dezelfde Verificatie om hun geverifieerde identiteitsgegevens op te halen en te reageren op [RFI's](https://docs.whop.com/nl/developer/verification/rfis.md) van downstream uitbetalingsproviders.

Maak een Verificatie aan wanneer een account moet worden geverifieerd voordat het transacties kan uitvoeren — doorgaans vóór de eerste [uitbetaling](https://docs.whop.com/nl/api-reference/payouts/payout). Zorg er vóór het aanmaken voor dat je een [account](https://docs.whop.com/nl/api-reference/accounts/account) hebt met een grootboekrekening (die automatisch wordt aangemaakt wanneer je het account aanmaakt). Maak niet meerdere Verificaties van hetzelfde `kind` aan op hetzelfde account — elk account ondersteunt maximaal één actief individueel profiel (KYC) en één bedrijfsprofiel (KYB). De Verificatie doorloopt meerdere statussen terwijl de gebruiker het proces voltooit: `pending` terwijl ze KYC doorlopen, `approved` zodra de identiteit is bevestigd, `rejected` als de provider weigert, en `action_required` wanneer een uitbetalingsprovider aanvullende informatie nodig heeft, zoals een bankafschrift of fiscaal nummer.

Succesvolle Verificaties leveren een volledig geverifieerde identiteit op met bevestigde naam, geboortedatum, land en adres — waarmee het account wordt vrijgegeven voor [uitbetalingen](https://docs.whop.com/nl/api-reference/legacy/payout-accounts/payout-account.md). Als je een Verificatie aanmaakt met vooraf ingevulde velden (`first_name`, `address`, enz.), worden zowel de verificatie als het gehoste KYC-formulier automatisch gevuld, zodat de gebruiker informatie die je al hebt niet opnieuw hoeft in te voeren. We raden aan te luisteren naar de [webhooks](https://docs.whop.com/nl/api-reference/legacy/webhooks/webhook.md) `identity_profile.approved` en `identity_profile.rejected` in plaats van te pollen, om in realtime op statuswijzigingen te reageren. Met Verificaties kun je gebruikers via één API-integratie onboarden voor uitbetalingen, ook wanneer de onderliggende KYC-providers en compliance-eisen in de loop van de tijd veranderen.

## Endpoints

| Methode | Pad | Beschrijving |
| - | - | - |
| `GET` | `/verifications?account_id={biz_ tag}` | [Verificaties weergeven](https://docs.whop.com/nl/developer/verification/retrieve.md) voor een account |
| `GET` | `/verifications/{verification_id}` | [Eén verificatie ophalen](https://docs.whop.com/nl/developer/verification/retrieve.md) via de `idpf_`-tag |
| `POST` | `/verifications` | [Een verificatie aanmaken](https://docs.whop.com/nl/developer/verification/overview.md) en een KYC/KYB-sessie starten |
| `PATCH` | `/verifications/{verification_id}` | [Identiteitsvelden bijwerken of op RFI's reageren](https://docs.whop.com/nl/developer/verification/manage.md) |
| `DELETE` | `/verifications/{verification_id}` | [Zacht verwijderen](https://docs.whop.com/nl/developer/verification/manage.md) en ontkoppelen van het account |

## Statussen

| Status | Beschrijving | Volgende stap |
| - | - | - |
| `not_started` | Verificatie bestaat, maar er is nog geen KYC-sessie gestart | Roep `POST /verifications` aan om te starten |
| `pending` | Gebruiker moet KYC voltooien via de `session_url` | Stuur de gebruiker door naar `session_url` |
| `approved` | KYC geslaagd — het account kan transacties uitvoeren | Geen actie nodig |
| `rejected` | KYC is geweigerd door de provider | Roep `POST /verifications` aan met `restart: true` |
| `action_required` | Een uitbetalingsprovider heeft aanvullende informatie nodig | Controleer de `rfis`-array en [reageer](https://docs.whop.com/nl/developer/verification/rfis.md) |

```json Example theme={null}
{
	"id": "verf_xxxxxxxxxxxxx",
	"last_error_code": "abandoned",
	"last_error_reason": "Document image was too blurry to read.",
	"status": "requires_input"
}
```

**id** `string` *required*

De numerieke id van het verificatierecord.

Voorbeeld: `verf_xxxxxxxxxxxxx`

**last\_error\_code** `VerificationErrorCodes | null` *required*

De meest recente foutcode die tijdens de verificatie is geretourneerd. Null als er geen fout is opgetreden.

Beschikbare opties: `abandoned`, `consent_declined`, `country_not_supported`, `device_not_supported`, `document_expired`, `document_type_not_supported`, `document_unverified_other`, `email_unverified_other`, `email_verification_declined`, `id_number_insufficient_document_data`, `id_number_mismatch`, `id_number_unverified_other`, `phone_unverified_other`, `phone_verification_declined`, `selfie_document_missing_photo`, `selfie_face_mismatch`, `selfie_manipulated`, `selfie_unverified_other`, `under_supported_age`

**last\_error\_reason** `string | null` *required*

Een voor mensen leesbare uitleg van de meest recente verificatiefout. Null als er geen fout is opgetreden.

Voorbeeld: `Document image was too blurry to read.`

**status** `VerificationStatuses` *required*

De huidige status van deze verificatiesessie.

Beschikbare opties: `requires_input`, `processing`, `verified`, `canceled`, `created`, `started`, `submitted`, `approved`, `declined`, `resubmission_requested`, `expired`, `abandoned`, `review`, `action_required`, `manual_review`
