Skip to main content
Deze resource heeft een opvolger in de Whop API, de API met versies waarop nieuwe integraties moeten bouwen. Deze pagina blijft volledig ondersteund.
Een Verificatie begeleidt een persoon of bedrijf door de identiteitscontroles die nodig zijn om uitbetalingen op een account te ontvangen. Personen doorlopen Know Your Customer-controles (KYC) en bedrijven doorlopen Know Your Business-controles (KYB). Maak bijvoorbeeld een Verificatie aan vóór de eerste uitbetaling van een gebruiker. Je kunt hun naam en adres vooraf invullen, zodat ze het gehoste formulier kunnen voltooien zonder een eigen verificatie-UI. Gebruik later dezelfde Verificatie om hun geverifieerde identiteitsgegevens op te halen en te reageren op RFI’s van downstream uitbetalingsproviders. Maak een Verificatie aan wanneer een account moet worden geverifieerd voordat het transacties kan uitvoeren — doorgaans vóór de eerste uitbetaling. Zorg er vóór het aanmaken voor dat je een account hebt met een grootboekrekening (die automatisch wordt aangemaakt wanneer je het account aanmaakt). Maak niet meerdere Verificaties van hetzelfde kind aan op hetzelfde account — elk account ondersteunt maximaal één actief individueel profiel (KYC) en één bedrijfsprofiel (KYB). De Verificatie doorloopt meerdere statussen terwijl de gebruiker het proces voltooit: pending terwijl ze KYC doorlopen, approved zodra de identiteit is bevestigd, rejected als de provider weigert, en action_required wanneer een uitbetalingsprovider aanvullende informatie nodig heeft, zoals een bankafschrift of fiscaal nummer. Succesvolle Verificaties leveren een volledig geverifieerde identiteit op met bevestigde naam, geboortedatum, land en adres — waarmee het account wordt vrijgegeven voor uitbetalingen. Als je een Verificatie aanmaakt met vooraf ingevulde velden (first_name, address, enz.), worden zowel de verificatie als het gehoste KYC-formulier automatisch gevuld, zodat de gebruiker informatie die je al hebt niet opnieuw hoeft in te voeren. We raden aan te luisteren naar de webhooks identity_profile.approved en identity_profile.rejected in plaats van te pollen, om in realtime op statuswijzigingen te reageren. Met Verificaties kun je gebruikers via één API-integratie onboarden voor uitbetalingen, ook wanneer de onderliggende KYC-providers en compliance-eisen in de loop van de tijd veranderen.

Endpoints

Statussen

string
vereist
De numerieke id van het verificatierecord.Voorbeeld: verf_xxxxxxxxxxxxx
VerificationErrorCodes | null
vereist
De meest recente foutcode die tijdens de verificatie is geretourneerd. Null als er geen fout is opgetreden.Beschikbare opties: abandoned, consent_declined, country_not_supported, device_not_supported, document_expired, document_type_not_supported, document_unverified_other, email_unverified_other, email_verification_declined, id_number_insufficient_document_data, id_number_mismatch, id_number_unverified_other, phone_unverified_other, phone_verification_declined, selfie_document_missing_photo, selfie_face_mismatch, selfie_manipulated, selfie_unverified_other, under_supported_age
string | null
vereist
Een voor mensen leesbare uitleg van de meest recente verificatiefout. Null als er geen fout is opgetreden.Voorbeeld: Document image was too blurry to read.
VerificationStatuses
vereist
De huidige status van deze verificatiesessie.Beschikbare opties: requires_input, processing, verified, canceled, created, started, submitted, approved, declined, resubmission_requested, expired, abandoned, review, action_required, manual_review