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.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.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.

