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
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 eenPATCH 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 alsvalue. 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 objectaddress door:
cURL
Documenten
Upload eerst het bestand en geef daarna het ID ervan door infiles:
cURL
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 lijstfiles, in paginavolgorde:
Identiteitsdocumenten
Eenid_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
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
value_type: "vault_token".
Geweigerde antwoorden
Als Whop een ingediend antwoord weigert, keert het item terug naarrequested_information met errors ingesteld:
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, noemtcode 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
Derequirement 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 — hetlabel vertelt je gebruiker voor welk account het is.

