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

# RFI's voor verificatie afhandelen

> Reageer wanneer Whop meer informatie nodig heeft — een document, fiscaal nummer of bedrijfsgegeven.

Whop doet een **Request for Information (RFI)** wanneer het iets extra's van een gebruiker nodig heeft — een document, fiscaal nummer of bedrijfsgegeven. Elke openstaande RFI verschijnt in de array `requested_information` van de verificatie. De `status` van de verificatie blijft `action_required` totdat de gebruiker elk item heeft beantwoord.

Elk item staat voor één ding dat je moet verzamelen, en dat beantwoord je met één schrijfactie. Een `requirement` noemt wat er nodig is, een invoer-`type` vertelt je hoe je het verzamelt, en een `label` levert tekst die je aan de gebruiker toont. De response laat sleutels weg die niet op een item van toepassing zijn. Zie [alle vereisten](#every-requirement) voor de volledige catalogus.

## Hoe RFI's werken

**1. Er wordt informatie aangevraagd**

Whop geeft aan dat er iets nodig is. De verificatiestatus verandert in `action_required` en er wordt een webhook `identity_profile.updated` geactiveerd. (`identity_profile.needs_action` wordt bij deze overgang ook geactiveerd, maar `identity_profile.updated` is de verzamelwebhook die elke statuswijziging dekt — abonneer je daarop en haal de verificatie opnieuw op om te zien wat er nog openstaat.)

**2. Je leest de items**

Roep `GET /api/v1/verifications?account_id={biz_ tag}` aan. De array `requested_information` op elke verificatie vermeldt wat er nodig is en welk soort antwoord je moet verzamelen.

**3. Je verzamelt en verstuurt**

Haal de informatie op bij je gebruiker en stuur die terug via `PATCH /api/v1/verifications/{id}` met een array `requested_information`. Whop stuurt elk antwoord naar de juiste plek.

**4. De beoordeling gaat verder**

Beantwoorde items verdwijnen uit de array. Zodra die leeg is, gaat de verificatie naar `processing` terwijl de antwoorden worden beoordeeld — in die status hoef je niets in te dienen. Ze eindigt op `approved`, of op `manual_review` als er een compliancebeoordeling wordt geopend. Als een antwoord wordt geweigerd, keert het item terug naar `action_required` met `errors` die uitleggen waarom. Dien het opnieuw in.

## RFI's lezen

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

Als er RFI's openstaan, ziet de verificatie er zo uit:

```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"
    }
  ]
}
```

### Itemvelden

| Veld | Beschrijving |
| - | - |
| `id` | De identifier van het item, met voorvoegsel `inrqi_` — neem die op wanneer je een antwoord indient |
| `requirement` | Wat Whop nodig heeft, zoals `ssn` of `bank_statement` — zie [alle vereisten](#every-requirement) |
| `type` | Wat je terugstuurt: `files`, `id_document`, `text`, `date`, `phone`, `select` of `address` |
| `label` | Wat je aan je gebruiker toont. Bevat de eigen notitie van de beoordelaar als die er is |
| `options` | Toegestane waarden voor een `select`-item, of de geaccepteerde ID-types voor een `id_document`-item |
| `optional` | Verschijnt als `true` wanneer de gebruiker het item mag overslaan |
| `errors` | Aanwezig na een geweigerd antwoord, elk met een stabiele `code` en een leesbare `reason` |

De response retourneert alleen de sleutels die op een item van toepassing zijn, dus een item bevat nooit een lege array of een `null` waarop je moet controleren.

De response retourneert alleen openstaande items — beantwoorde items verdwijnen uit de array, dus alles wat er nog in staat, moet de gebruiker nog aanleveren. De verificatie blijft `action_required` totdat de array leeg is.

## RFI's beantwoorden

Stuur een `PATCH` naar de `idpf_`-tag van de verificatie met een array `requested_information`. Elk item heeft het item-`id` nodig en precies één antwoordpayload die past bij het `type` van het item:

| Item-`type` | Antwoordpayload |
| - | - |
| `files` | `files` — één document, als lijst van de pagina's |
| `id_document` | `documents` — de slotsleutels voor het identiteitsbewijs dat je uploadt |
| `text`, `date`, `phone`, `select` | `value` |
| `address` | Object `address` |

Je stuurt verder niets van het item terug — geen categorieën of documenttypes. Het item-`id` vertelt Whop waar het antwoord thuishoort.

Je kunt meerdere items in één verzoek beantwoorden:

```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" }
    ]
  }'
```

### Tekst-, datum-, telefoon- en selectiewaarden

Geef het antwoord door als `value`. Datums gebruiken `YYYY-MM-DD`, telefoonnummers gebruiken het E.164-formaat (`+12125550123`) en selectiewaarden moeten een van de `options` van het item zijn.

### Adressen

Geef een object `address` door:

```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"
        }
      }
    ]
  }'
```

Postbussen worden niet geaccepteerd voor persoonlijke adressen of bedrijfsadressen.

### Documenten

[Upload eerst het bestand](https://docs.whop.com/nl/developer/guides/upload-files.md) en geef daarna het ID ervan door in `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"] }
    ]
  }'
```

Elk item accepteert een `file_`-ID uit de [uploadflow](https://docs.whop.com/nl/developer/guides/upload-files.md) of een `direct_upload_id` van een directe upload. Documenten moeten Joint Photographic Experts Group- (JPEG), Portable Network Graphics- (PNG) of PDF-bestanden van maximaal 32 MB zijn. Een document van één pagina is een lijst met één item — er is geen apart veld voor één bestand.

De `requirement` noemt het document dat Whop nodig heeft, en Whop regelt de rest — je geeft nooit aan wat voor document je hebt geüpload.

#### Documenten met meerdere pagina's

Een document met meerdere pagina's komt in dezelfde lijst `files`, in paginavolgorde:

```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"] }
```

#### Identiteitsdocumenten

Een `id_document`-item vraagt om welk identiteitsbewijs het gaat. Het bevat `options` met de ID-types die de beoordeling accepteert, en het antwoord benoemt elk slot met dezelfde sleutels die [Create Verification](https://docs.whop.com/nl/api-reference/verifications/create-verification.md) accepteert:

```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"
        }
      }
    ]
  }'
```

De sleutel benoemt het document en de zijde tegelijk, dus er is geen apart veld voor welk identiteitsbewijs het document is — Whop leidt dat af uit de sleutels. Verstuur elk slot voor het document dat je uploadt:

| ID-type | Slots |
| - | - |
| `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 weigert gemengde slots van twee documenten of een onvolledig document voordat er iets wordt opgeslagen. De `options` op het item vermelden welke ID-types die beoordeling accepteert.

Als een bestandsitem geen `options` heeft, heeft het geen `value` nodig.

### Gevoelige waarden

Dien fiscale nummers en overheidsidentificatienummers (`ssn`, `ein`, `company_tax_id`, `personal_id_number`) in zoals elke andere waarde. Whop vervangt ze tijdens de overdracht door beveiligde tokens en slaat alleen de beveiligde referentie op:

```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" }
    ]
  }'
```

Als je waarden al zelf tokeniseert (Basis Theory), geef dan in plaats daarvan het token-ID door met `value_type: "vault_token"`.

## Geweigerde antwoorden

Als Whop een ingediend antwoord weigert, keert het item terug naar `requested_information` met `errors` ingesteld:

```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."
    }
  ]
}
```

Toon `reason` aan je gebruiker en vertak op `code` als dat nodig is. Behandel onbekende codes als een algemene weigering.

Los het onderliggende probleem op en dien opnieuw in met hetzelfde item-`id`. De verificatie blijft `action_required` totdat Whop het gecorrigeerde antwoord accepteert.

### Weigeringscodes voor documenten

Als Whop een geüpload document weigert, noemt `code` wat er mis mee was. Dit zijn de codes die je kunt ontvangen:

| Code | Betekenis |
| - | - |
| `bad_proof_of_identity` | Whop accepteert het identiteitsbewijs niet — lever een door de overheid uitgegeven identiteitsbewijs met foto aan |
| `expiration_date` | Het document is verlopen |
| `unsatisfactory_photos` | Te onduidelijk om te lezen |
| `problematic_applicant_data` | Ingediende gegevens komen niet overeen met het document |
| `screenshots` | De gebruiker heeft een screenshot geüpload in plaats van een foto van het document |
| `graphic_editor` | Het document lijkt bewerkt |
| `digital_document` | De gebruiker heeft een digitale kopie geüpload. Lever een foto van het fysieke document aan |
| `document_damaged` | Beschadigd of gedeeltelijk onleesbaar |
| `document_page_missing` | Er ontbreekt een pagina |
| `document_missing` | Het document is niet ontvangen |
| `not_document` | Het bestand is geen document |
| `id_invalid` | Het identiteitsdocument is niet geldig |
| `incompatible_language` | Niet-ondersteunde taal. Lever een beëdigde vertaling aan |
| `bad_selfie` | De selfie was onduidelijk |
| `bad_face_matching` | De selfie kwam niet overeen met de foto op het document |
| `bad_proof_of_address` | Geen geaccepteerd adresbewijs |
| `wrong_address` | Het adres komt niet overeen met het document |
| `incorrect_social_number` | Het fiscale identificatienummer komt niet overeen met het document |
| `company_incorrect_data` | Accountgegevens komen niet overeen met het registratiedocument |
| `company_data_mismatch` | Accountgegevens komen niet overeen met de gegevens van Whop |
| `company_inactive_entity` | Het account staat niet als actief in het register |
| `additional_document_required` | Whop heeft nog een document nodig |
| `more_documents_required` | Whop heeft meer documenten nodig |
| `db_data_mismatch` | Ingediende gegevens komen niet overeen met officiële registraties |
| `spam` | Whop kon de inzending niet verwerken |

Elke code hier beschrijft een herstelbaar probleem met de upload. Een weigering die Whop niet aan een van deze codes kan toeschrijven, retourneert geen `errors` in plaats van een onbruikbare code. Handel altijd een item zonder `errors` af, en gebruik bij voorkeur `reason` voor tekst die je aan gebruikers toont.

## Alle vereisten

De `requirement` van elk item is een van de onderstaande waarden.

### Persoonsgegevens

| Vereiste | Type | Wat je indient |
| - | - | - |
| `first_name` | `text` | Wettelijke voornaam, met hoofdletter (`Jane`) |
| `last_name` | `text` | Wettelijke achternaam, met hoofdletter (`Doe`) |
| `creator_legal_name` | `text` | Volledige wettelijke naam zoals die op officiële documenten staat |
| `date_of_birth` | `date` | `YYYY-MM-DD` |
| `email` | `text` | E-mailadres |
| `creator_email_address` | `text` | Een e-mailadres waarop Whop de gebruiker kan bereiken |
| `phone_number` | `phone` | E.164-formaat met landcode (`+12125550123`) |
| `personal_address` | `address` | Huidig woonadres — geen postbussen |
| `occupation` | `text` | Standard Occupational Classification-code (`15-1132`), of `SELFEMP`, `STUDENT`, `RETIRED`, `UNEMPLO`, `OTHERXX` |
| `annual_salary` | `text` | Geschat jaarinkomen in Amerikaanse dollars, alleen cijfers |

### Fiscale nummers en overheidsidentificatienummers

Whop vervangt deze waarden tijdens de overdracht door beveiligde tokens — zie [gevoelige waarden](#sensitive-values).

| Vereiste | Type | Wat je indient |
| - | - | - |
| `ssn` | `text` | Amerikaans Social Security Number, `XXX-XX-XXXX` |
| `ein` | `text` | Amerikaans Employer Identification Number, `XX-XXXXXXX` |
| `company_tax_id` | `text` | Fiscaal nummer van het account in het formaat van het land van uitgifte |
| `personal_id_number` | `text` | Door de overheid uitgegeven persoonlijk identificatienummer (paspoort, rijbewijs, nationale identiteitskaart) |
| `personal_id_number_country` | `select` | Land dat het identificatienummer heeft uitgegeven — kies uit `options` |
| `country_of_issue` | `text` | Tweeletterige landcode van het land van uitgifte (`US`) |

### Identiteitsdocumenten

| Vereiste | Type | Wat je indient |
| - | - | - |
| `identity_document` | `id_document` | Door de overheid uitgegeven identiteitsbewijs met foto. Stuur `documents` met de slotsleutels voor het identiteitsbewijs dat de gebruiker uploadt |
| `selfie` | `files` | Foto van de gebruiker die zijn identiteitsbewijs vasthoudt |

### Bedrijfsgegevens

| Vereiste | Type | Wat je indient |
| - | - | - |
| `business_name` | `text` | De geregistreerde wettelijke naam van het bedrijf |
| `trade_name` | `text` | Publieke naam als die afwijkt van de wettelijke naam (handelsnaam) |
| `company_title` | `text` | De naam van het account |
| `business_structure` | `select` | Rechtsvorm — een van de `options`, bijv. `single_member_llc`, `sole_proprietorship`, `private_corporation` |
| `account_type` | `select` | `individual`, `company` of `non_profit` |
| `business_representative_title` | `select` | Functietitel van de vertegenwoordiger — een van de `options`, bijv. `CEO`, `Owner`, `Manager` |
| `industry_type` | `text` | Branche waarin het bedrijf actief is |
| `business_description` | `text` | 100–1000 tekens: wat er wordt verkocht, wat klanten na betaling ontvangen en waar ze er toegang toe krijgen |
| `product_description` | `text` | Het verkochte product of de verkochte dienst |
| `business_phone_number` | `phone` | E.164-formaat met landcode |
| `business_address` | `address` | Geregistreerd bedrijfsadres — geen postbussen |
| `business_website` | `text` | URL van de bedrijfswebsite |
| `social_media_or_website` | `text` | Website, of een openbaar socialemediaprofiel dat weergeeft wat er wordt verkocht |
| `store_page_url` | `text` | Link naar de winkel- of productpagina |
| `expected_monthly_volume` | `text` | Verwacht maandelijks verwerkingsvolume in Amerikaanse dollars, alleen cijfers |
| `account_purpose` | `text` | Waarvoor het account voornamelijk wordt gebruikt |

### Bedrijfsdocumenten

| Vereiste | Type | Wat je indient |
| - | - | - |
| `business_verification_document` | `files` | Document dat de juridische identiteit van het account bevestigt: Internal Revenue Service (IRS) Letter 147C, SS-4 of Employer Identification Number (EIN) Assistance Letter |
| `business_incorporation_papers` | `files` | Officiële oprichtingsdocumenten |
| `ownership_structure` | `files` | Documenten waaruit blijkt wie eigenaar is van het bedrijf |
| `processing_statements` | `files` | Overzichten van een vorige betalingsverwerker met de verwerkingsgeschiedenis — geen bankafschriften |
| `proof_of_fulfillment` | `files` | Screenshot, opname of bestand dat laat zien wat klanten na aankoop ontvangen |
| `proof_of_funnel` | `text` of `files` | Waar klanten vandaan komen — een socialemedia-account, website of landingspagina |

### Documenten voor het uitbetalingsaccount

Een document dat wordt aangevraagd om een uitbetalingsbestemming te verifiëren, noemt het document zelf. Upload één bestand — het `label` vertelt je gebruiker voor welk account het is.

| Vereiste | Type | Wat je indient |
| - | - | - |
| `bank_statement` | `files` | Recent bankafschrift van het uitbetalingsaccount |
| `paper_check` | `files` | Ongeldig gemaakte papieren cheque |
| `wallet_screenshot` | `files` | Screenshot van een wallet- of rekeningsaldo |
| `government_id` | `files` | Door de overheid uitgegeven identiteitsbewijs |
| `proof_of_address` | `files` | Adresbewijs uitgegeven in de afgelopen 3 maanden |
| `utility_bill` | `files` | Energierekening uitgegeven in de afgelopen 3 maanden |
| `insurance_card` | `files` | Verzekeringspas uitgegeven in de afgelopen 3 maanden |
| `company_documents` | `files` | Account- of entiteitsdocumenten |

### Beoordelingsvragen

| Vereiste | Type | Wat je indient |
| - | - | - |
| `anything_else` | `text` of `files` | Al het andere dat het beoordelingsteam moet weten |
| `accept_tos` | `text` | Bevestiging dat de gebruiker de servicevoorwaarden accepteert |
| `signature` | `files` | Afbeelding van een handtekening voor een overeenkomst |


## Related topics

- [Verificatie](https://docs.whop.com/nl/api-reference/legacy/verifications/verification.md)
- [Identiteit van gebruikers verifiëren met KYC](https://docs.whop.com/nl/developer/verification/overview.md)
- [Verificatiestatus controleren](https://docs.whop.com/nl/developer/verification/retrieve.md)
