Skip to main content

Sådan fungerer det

1

Start en verificering

Kald POST /api/v1/verifications med den konto, du vil verificere. Du får en session_url tilbage.
2

Send brugeren videre for at gennemføre KYC

Omdirigér din bruger til session_url. Brugeren uploader sit ID, tager en selfie og verificerer sin identitet på en hostet side. Du bygger ingen UI til dette.
3

Lyt efter resultatet

Abonnér på identity_profile.updated-webhooken – den udløses ved hver ændring af profilen (godkendt, afvist, kræver handling, eller en gennemgang, der åbnes eller lukkes). Webhooken fortæller dig, hvilken profil der ændrede sig, ikke dens nye tilstand, så kald GET /api/v1/verifications?account_id={biz_ tag} for at læse den aktuelle status og de verificerede identitetsdata.

Hurtigt eksempel

cURL
Response
Du skal bruge en Account API-nøgle med scopet identity:write. Se Godkendelse og API-nøgler for typerne af legitimationsoplysninger, og hvordan du afgrænser dem. Gå til dit dashboard → Settings → API Keys for at oprette en.

Forudfyld formularen til identitetsverificering

Send identitetsfelter med for at springe trin over for din bruger. De forudfylder verificeringsformularen, så brugeren ikke skal indtaste sit navn og sin adresse igen:
cURL
tax_identification_number er personens skatteidentifikationsnummer – deres SSN for amerikanske privatpersoner – og er påkrævet, når country er US: udbetalingskontoen kan ikke oprettes uden det. Send det, som det er. Det tokeniseres under overførslen, og den rå værdi gemmes aldrig i Whops systemer.
Whop kan ikke understøtte brugere i et sanktioneret land eller område. Anmodningen fejler med en 400 og fejlkoden address_country_sanctioned.

Genbrug en verificering, du allerede har

Hvis du allerede har verificeret denne person med Sumsub, så send personens share token i stedet for at lade vedkommende gennemgå KYC en gang til. Whop importerer den identitet, som din Sumsub-konto har attesteret, og tjekker den op mod Whops egne krav:
cURL
Response
1

Indgå en aftale om Reusable KYC med Whop

Sumsub frigiver kun ansøgerdata mellem klienter, der har en Reusable KYC-aftale. Whop giver dig det klient-ID, der skal deles med, når den er på plads.
2

Generér et share token til ansøgeren

Kald POST https://api.sumsub.com/resources/accessTokens/shareToken på din egen Sumsub-konto med ansøgerens ID og Whops klient-ID som forClientId.
3

Send det til Whop

Send tokenet som share_token. Hvert token virker én gang.
Svaret fortæller dig, hvor det endte. approved betyder, at din verificering dækkede alt, hvad Whop har brug for, og at der ikke er mere at gøre. pending med en session_url betyder, at den dækkede en del af det – send brugeren til den URL for kun at færdiggøre det, der stadig mangler. Whop afviser et token, hvis data ikke dækker nogen af kravene, med en 400.
share_token kan ikke kombineres med documents eller document_type – hver af dem er et komplet alternativ til det hostede forløb.

To typer verificering

En konto kan have én af hver – en individuel KYC og en virksomheds-KYB.

Hvad er det næste

Tjek status

Tjek verificeringsstatus, og læs verificerede identitetsdata.

Håndtér RFI'er

Svar, når Whop har brug for yderligere oplysninger, f.eks. et kontoudtog.

Opdatér og slet

Opdatér identitetsfelter, eller fjern en verificering.

API-reference

Fuld feltreference for verificeringsobjektet.