Skip to main content
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 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

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

Itemvelden

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: 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:
cURL

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:
cURL
Postbussen worden niet geaccepteerd voor persoonlijke adressen of bedrijfsadressen.

Documenten

Upload eerst het bestand en geef daarna het ID ervan door in files:
cURL
Elk item accepteert een file_-ID uit de uploadflow 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:

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 accepteert:
cURL
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: 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:
cURL
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:
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: 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

Fiscale nummers en overheidsidentificatienummers

Whop vervangt deze waarden tijdens de overdracht door beveiligde tokens — zie gevoelige waarden.

Identiteitsdocumenten

Bedrijfsgegevens

Bedrijfsdocumenten

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.

Beoordelingsvragen