Skip to main content
Whop opretter en Request for Information (RFI), når der er brug for noget ekstra fra en bruger – et dokument, et skatte-ID eller en virksomhedsoplysning. Hver åben RFI vises i verificeringens requested_information-array. Verificeringens status forbliver action_required, indtil brugeren har besvaret alle punkter. Hvert punkt repræsenterer én ting, der skal indsamles, og som du besvarer med én skrivning. Et requirement angiver, hvad der er brug for, en input-type fortæller dig, hvordan det skal indsamles, og en label giver tekst, der vises for brugeren. Svaret udelader nøgler, der ikke gælder for et punkt. Se alle krav for det fulde katalog.

Sådan fungerer RFI’er

1

Der anmodes om oplysninger

Whop markerer, at der er brug for noget. Verificeringsstatussen skifter til action_required, og en identity_profile.updated-webhook udløses. (identity_profile.needs_action udløses også ved denne overgang, men identity_profile.updated er den samlende hændelse, der dækker alle tilstandsændringer – abonnér på den, og hent verificeringen igen for at se, hvad der udestår.)
2

Du læser punkterne

Kald GET /api/v1/verifications?account_id={biz_ tag}. requested_information-arrayet på hver verificering viser, hvad der er brug for, og hvilken type svar der skal indsamles.
3

Du indsamler og indsender

Hent oplysningerne fra din bruger, og send dem tilbage via PATCH /api/v1/verifications/{id} med et requested_information-array. Whop sender hvert svar det rigtige sted hen.
4

Gennemgangen fortsætter

Besvarede punkter forsvinder fra arrayet. Når det er tomt, skifter verificeringen til processing, mens svarene gennemgås – der er intet at indsende i den tilstand. Den ender på approved eller på manual_review, hvis der åbnes en compliance-gennemgang. Hvis et svar afvises, vender punktet tilbage til action_required med errors, der forklarer hvorfor. Indsend det igen.

Læsning af RFI’er

cURL
Når der er udestående RFI’er, ser verificeringen sådan ud:

Punktfelter

Svaret returnerer kun de nøgler, der gælder for et punkt, så et punkt indeholder aldrig et tomt array eller en null, du skal tjekke for. Svaret returnerer kun åbne punkter – besvarede punkter forsvinder fra arrayet, så brugeren mangler stadig alt, hvad der er til stede. Verificeringen forbliver action_required, indtil arrayet er tomt.

Besvarelse af RFI’er

Send en PATCH til verificeringens idpf_-tag med et requested_information-array. Hver post kræver punktets id og præcis én svar-payload, der matcher punktets type: Svaret gentager intet andet fra punktet – ingen kategorier eller dokumenttyper. Punktets id fortæller Whop, hvor svaret hører hjemme. Du kan besvare flere punkter i én anmodning:
cURL

Tekst-, dato-, telefon- og select-værdier

Send svaret som value. Datoer bruger YYYY-MM-DD, telefonnumre bruger E.164-format (+12125550123), og select-værdier skal være en af punktets options.

Adresser

Send et address-objekt:
cURL
Postbokse accepteres ikke for personlige adresser eller virksomhedsadresser.

Dokumenter

Upload filen først, og send derefter dens ID i files:
cURL
Hver post tager enten et file_-ID fra upload-forløbet eller et direct_upload_id fra en direkte upload. Dokumenter skal være Joint Photographic Experts Group (JPEG)-, Portable Network Graphics (PNG)- eller PDF-filer på op til 32 MB. Et dokument på én side er en liste med ét element – der er ikke et separat felt til en enkelt fil. requirement angiver det dokument, Whop har brug for, og Whop håndterer resten – du angiver aldrig, hvilken slags dokument du har uploadet.

Dokumenter med flere sider

Et dokument med flere sider går i den samme files-liste, i siderækkefølge:

Identitetsdokumenter

Et id_document-punkt spørger, hvilket ID det er. Det indeholder options med de ID-typer, gennemgangen accepterer, og svaret navngiver hvert slot med de samme nøgler, som Create Verification tager:
cURL
Nøglen angiver både dokumentet og siden på én gang, så der er ikke et separat felt for, hvilket ID dokumentet repræsenterer – Whop udleder det af nøglerne. Send alle slots for det, du uploader: Whop afviser blandede slots fra to dokumenter eller et ufuldstændigt dokument, før noget gemmes. options på punktet angiver, hvilke ID-typer den gennemgang accepterer. Hvis et filpunkt ikke har nogen options, kræver det ingen value.

Følsomme værdier

Indsend skattenumre og offentlige ID-numre (ssn, ein, company_tax_id, personal_id_number) som enhver anden værdi. Whop erstatter dem med sikre tokens under overførslen og gemmer kun den sikre reference:
cURL
Hvis du allerede selv tokeniserer værdier (Basis Theory), så send i stedet token-ID’et med value_type: "vault_token".

Afviste svar

Hvis Whop afviser et indsendt svar, vender punktet tilbage til requested_information med errors angivet:
Vis reason til din bruger, og forgren på code, hvis du har brug for det. Behandl ukendte koder som en generisk afvisning. Ret det underliggende problem, og indsend igen med det samme punkt-id. Verificeringen forbliver action_required, indtil Whop accepterer det rettede svar.

Afvisningskoder for dokumenter

Når Whop afviser et uploadet dokument, angiver code, hvad der var galt med det. Dette er de koder, du kan modtage: Hver kode her beskriver et problem med uploaden, der kan rettes. En afvisning, som Whop ikke kan henføre til en af dem, returnerer ingen errors i stedet for en ubrugelig kode. Håndtér altid et punkt uden errors, og foretræk reason til tekst, der vises for brugeren.

Alle krav

Hvert punkts requirement er en af værdierne nedenfor.

Personlige oplysninger

Skattenumre og offentlige identifikationsnumre

Whop erstatter disse værdier med sikre tokens under overførslen – se følsomme værdier.

Identitetsdokumenter

Virksomhedsoplysninger

Virksomhedsdokumenter

Dokumenter til udbetalingskonto

Et dokument, der anmodes om for at verificere en udbetalingsdestination, angiver selve dokumentet. Upload én fil – label fortæller din bruger, hvilken konto det gælder.

Gennemgangsspørgsmål