Workflow API di onboarding individuale

​

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 con POST /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

Leggi GET /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

Leggi GET /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.

​

4. Recupera il dettaglio del task corrente

Elenca i task del customer con GET /v3/customers/{customerId}/tasks. Recupera la superficie di azione autorizzata con GET /v3/customers/{customerId}/tasks/{taskId}. Il dettaglio del task puo’ esporre URL di sessioni hosted di prima parte e i requisiti azionabili correnti. Usa la sua revisione e status correnti.

​

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 con POST /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. Usa POST /v3/customers/{customerId}/documents, poi inserisci l’id del documento restituito nella risposta documentale applicabile.

​

7. Rileggi le risorse correnti

Rileggi il customer, la capability, le application e il task correnti dopo ogni evento o azione. Usa i loro ultimi stati, motivi, requisiti e id di task aperti per selezionare il passo successivo.

​

Mappa delle operazioni generate

​

Guida su policy e implementazione

Simplified, Standard ed Enhanced KYC sono tier di policy. Non sostituiscono gli stati correnti di capability, application, task, submission, requirement o hosted-session. Per i dettagli di implementazione, segui la guida di onboarding individuale, Capability e task e la guida ai documenti di integrazione.