Individuele onboarding API-workflow
Gebruik deze map om individueel KYC-beleid te verbinden met de huidige gegenereerde API-referentie. Volg bij elke stap de huidige resource in plaats van beleidsgerichte labels als API-state machine te implementeren.Workflow-map
1. Maak de individuele klant aan
Maak de klant aan metPOST /v3/customers. Sla de geretourneerde klant-ID op en lees de huidige resource met GET /v3/customers/{customerId}.
2. Ontdek en vraag een eligible capability aan
LeesGET /v3/customers/{customerId}/capabilities/supported. Selecteer alleen een variant wanneer de huidige availability en eligibility het request toestaan en gebruik dan POST /v3/customers/{customerId}/capabilities/{capabilityId}.
3. Lees de huidige capability en applications
LeesGET /v3/customers/{customerId}/capabilities/{capabilityId} en GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications. Volg huidige open task-ID’s in plaats van readiness aan te nemen op basis van een eerdere respons.
Voor named bank-capabilities heeft een klant één application-case per bank, gedeeld over compatibele capabilities. Zie Gedeelde applications per bank voor responscodes, selectedApplicationId en de lijst met applications van de klant.
4. Haal het huidige taakdetail op
Bekijk klanttaken metGET /v3/customers/{customerId}/tasks. Haal het geautoriseerde action surface op met GET /v3/customers/{customerId}/tasks/{taskId}.
Het taakdetail kan first-party hosted session URL’s en de huidige actionable requirements tonen. Gebruik de huidige revisie en status.
In intaketaken die directe indiening accepteren, gaan eligible vereisten die al worden onderbouwd door het profiel van de klant of geüploade documenten automatisch naar review. Bouw formulieren op basis van de metadata van elke vereiste. Zie Vereisten renderen.
5. Voltooi hosted sessions of dien taakantwoorden in
Wanneer het taakdetail een hosted session levert, retourneer je alleen de vereiste sessiedata naar je client en houd je de API-key op je backend. Wanneer de taak antwoorden vereist, maak je één volledige immutable attempt metPOST /v3/customers/{customerId}/tasks/{taskId}/submissions. Lees één huidige submission en de publieke outcome met GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}.
6. Upload documenten alleen wanneer gevraagd
Upload documenten alleen wanneer de huidige taak erom vraagt. GebruikPOST /v3/customers/{customerId}/documents en plaats vervolgens de geretourneerde document-ID in het toepasselijke document-antwoord.