Workflow API di onboarding individuale
Usa questa mappa per collegare la policy KYC individuale all’API reference generata corrente. Segui la risorsa corrente a ogni passo, invece di implementare le etichette viste dalla policy come una macchina a stati API.Mappa del workflow
1. Crea il customer individuale
Crea il customer conPOST /v3/customers. Salva l’id del customer restituito e leggi la risorsa corrente con GET /v3/customers/{customerId}.
2. Scopri e richiedi una capability idonea
LeggiGET /v3/customers/{customerId}/capabilities/supported. Seleziona una variante solo quando la sua availability ed eligibility correnti consentono la richiesta, poi usa POST /v3/customers/{customerId}/capabilities/{capabilityId}.
3. Leggi la capability corrente e le application
LeggiGET /v3/customers/{customerId}/capabilities/{capabilityId} e GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications. Segui gli id dei task aperti correnti invece di assumere la readiness da una risposta precedente.
Per le capability bancarie named, un customer ha un solo caso di application per banca, condiviso tra le capability compatibili. Consulta Application condivise per banca per i codici di risposta, selectedApplicationId e l’elenco delle application del customer.
4. Recupera il dettaglio del task corrente
Elenca i task del customer conGET /v3/customers/{customerId}/tasks. Recupera la superficie di azione autorizzata con GET /v3/customers/{customerId}/tasks/{taskId}.
Il dettaglio del task può esporre URL di sessioni hosted di prima parte e i requisiti azionabili correnti. Usa la sua revisione e status correnti.
Nei task di intake che accettano l’invio diretto, i requisiti idonei già supportati dal profilo o dai documenti caricati del customer passano automaticamente in revisione. Costruisci i form a partire dai metadati di ciascun requisito. Consulta Visualizza i requisiti.
5. Completa le sessioni hosted o invia le risposte al task
Quando il dettaglio del task fornisce una sessione hosted, restituisci al tuo client solo i dati di sessione necessari e mantieni la chiave API nel tuo backend. Quando il task richiede risposte, crea un tentativo immutabile e completo conPOST /v3/customers/{customerId}/tasks/{taskId}/submissions. Leggi una submission corrente e il suo outcome pubblico con GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}.
6. Carica i documenti solo quando richiesti
Carica documenti solo quando il task corrente li richiede. UsaPOST /v3/customers/{customerId}/documents, poi inserisci l’id del documento restituito nella risposta documentale applicabile.