Skip to main content

Hoe het werkt

1

Start een verificatie

Roep POST /api/v1/verifications aan met het account dat je wilt verifiëren. Je krijgt een session_url terug.
2

Stuur de gebruiker door om KYC te voltooien

Stuur je gebruiker door naar de session_url. Daar uploadt de gebruiker een identiteitsbewijs, maakt een selfie en verifieert zijn identiteit op een gehoste pagina. Je hoeft hiervoor zelf geen UI te bouwen.
3

Luister naar het resultaat

Abonneer je op de webhook identity_profile.updated — die wordt geactiveerd bij elke wijziging van het profiel (goedgekeurd, afgewezen, actie vereist, of een beoordeling die wordt geopend of afgerond). De webhook vertelt je welk profiel is gewijzigd, niet de nieuwe status ervan, dus roep GET /api/v1/verifications?account_id={biz_ tag} aan om de actuele status en de geverifieerde identiteitsgegevens te lezen.

Snel voorbeeld

cURL
Response
Je hebt een Account API-sleutel met de scope identity:write nodig. Zie Auth & API-sleutels voor de soorten inloggegevens en hoe je hun scope instelt. Ga naar je dashboard → Settings → API Keys om er een aan te maken.

Het identiteitsverificatieformulier vooraf invullen

Geef identiteitsvelden door om je gebruiker stappen te besparen. Deze vullen het verificatieformulier vooraf in, zodat de gebruiker naam en adres niet opnieuw hoeft te typen:
cURL
tax_identification_number is het fiscale identificatienummer van de persoon — het SSN voor personen in de VS — en is verplicht wanneer country US is: zonder dit nummer kan het uitbetalingsaccount niet worden aangemaakt. Stuur het ongewijzigd mee. Het wordt tijdens de overdracht getokeniseerd en de ruwe waarde wordt nooit opgeslagen in de systemen van Whop.
Whop kan geen gebruikers ondersteunen in een land of regio onder sancties. Het verzoek mislukt met een 400 en de foutcode address_country_sanctioned.

Een bestaande verificatie hergebruiken

Heb je deze persoon al met Sumsub geverifieerd, stuur dan diens share token in plaats van de persoon een tweede keer door KYC te laten gaan. Whop importeert de identiteit die je Sumsub-account heeft bevestigd en toetst die aan de eigen vereisten van Whop:
cURL
Response
1

Spreek Reusable KYC af met Whop

Sumsub geeft alleen aanvragergegevens vrij tussen clients die een Reusable KYC-overeenkomst hebben. Whop geeft je het client-ID om mee te delen zodra die overeenkomst er is.
2

Genereer een share token voor de aanvrager

Roep POST https://api.sumsub.com/resources/accessTokens/shareToken aan op je eigen Sumsub-account met het ID van de aanvrager en het client-ID van Whop als forClientId.
3

Stuur het naar Whop

Geef het token door als share_token. Elk token werkt één keer.
De response vertelt je waar het is beland. approved betekent dat je verificatie alles dekt wat Whop nodig heeft en dat er niets meer te doen is. pending met een session_url betekent dat ze een deel dekt — stuur de gebruiker naar die URL om alleen af te ronden wat nog ontbreekt. Whop weigert met een 400 een token waarvan de gegevens geen enkele vereiste dekken.
share_token kan niet worden gecombineerd met documents of document_type — elk daarvan is een volledig alternatief voor de gehoste flow.

Twee soorten verificatie

Een account kan van elk één hebben — een individuele KYC en een zakelijke KYB.

Volgende stappen

Status controleren

Controleer de verificatiestatus en lees geverifieerde identiteitsgegevens.

RFI's afhandelen

Reageer wanneer Whop aanvullende informatie nodig heeft, zoals een bankafschrift.

Bijwerken & verwijderen

Werk identiteitsvelden bij of verwijder een verificatie.

API-referentie

Volledige veldreferentie voor het verificatieobject.