> ## Documentation Index
> Fetch the complete documentation index at: https://docs.swipelux.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Workflow API di onboarding individuale

> Mappa la policy KYC individuale alle operazioni correnti di Customers, Capabilities, Tasks, Task Submissions e Documents.

## 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`](/api-reference/customers/post-v3-customers). Salva l'id del customer restituito e leggi la risorsa corrente con [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id).

### 2. Scopri e richiedi una capability idonea

Leggi [`GET /v3/customers/{customerId}/capabilities/supported`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-supported). Seleziona una variante solo quando la sua availability ed eligibility correnti consentono la richiesta, poi usa [`POST /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/post-v3-customers-by-customer-id-capabilities-by-capability-id).

### 3. Leggi la capability corrente e le application

Leggi [`GET /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id) e [`GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id-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`](/api-reference/tasks/list-customer-tasks). Recupera la superficie di azione autorizzata con [`GET /v3/customers/{customerId}/tasks/{taskId}`](/api-reference/tasks/get-customer-task).

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`](/api-reference/task-submissions/create-customer-task-submission). Leggi una submission corrente e il suo outcome pubblico con [`GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}`](/api-reference/task-submissions/get-customer-task-submission).

### 6. Carica i documenti solo quando richiesti

Carica documenti solo quando il task corrente li richiede. Usa [`POST /v3/customers/{customerId}/documents`](/api-reference/documents/post-v3-customers-by-customer-id-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

| Risorsa          | Operazione generata                                                                                                                                                                 | Uso                                                      |
| ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------- |
| Customers        | [`POST /v3/customers`](/api-reference/customers/post-v3-customers)                                                                                                                  | Crea il customer individuale                             |
| Customers        | [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id)                                                                                        | Leggi i dati correnti del customer                       |
| Capabilities     | [`GET /v3/customers/{customerId}/capabilities/supported`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-supported)                                       | Scopri availability ed eligibility correnti              |
| Capabilities     | [`POST /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/post-v3-customers-by-customer-id-capabilities-by-capability-id)                         | Richiedi la capability selezionata                       |
| Capabilities     | [`GET /v3/customers/{customerId}/capabilities/{capabilityId}`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id)                           | Leggi lo stato corrente della capability e i task aperti |
| Capabilities     | [`GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications`](/api-reference/capabilities/get-v3-customers-by-customer-id-capabilities-by-capability-id-applications) | Leggi le application di institution e i loro task aperti |
| Tasks            | [`GET /v3/customers/{customerId}/tasks`](/api-reference/tasks/list-customer-tasks)                                                                                                  | Elenca i task di proprieta' del customer                 |
| Tasks            | [`GET /v3/customers/{customerId}/tasks/{taskId}`](/api-reference/tasks/get-customer-task)                                                                                           | Leggi i requisiti correnti e le sessioni hosted          |
| Task Submissions | [`POST /v3/customers/{customerId}/tasks/{taskId}/submissions`](/api-reference/task-submissions/create-customer-task-submission)                                                     | Invia un set completo di risposte                        |
| Task Submissions | [`GET /v3/customers/{customerId}/tasks/{taskId}/submissions/{submissionId}`](/api-reference/task-submissions/get-customer-task-submission)                                          | Leggi lo snapshot autorizzato delle risposte e l'outcome |
| Documents        | [`POST /v3/customers/{customerId}/documents`](/api-reference/documents/post-v3-customers-by-customer-id-documents)                                                                  | Carica un file richiesto dal task corrente               |

## 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](/it/integration/onboarding/customers#individual-customers), [Capability e task](/it/integration/onboarding/capabilities-and-requirements#complete-current-tasks) e la [guida ai documenti di integrazione](/it/integration/onboarding/capabilities-and-requirements#upload-documents).


## Related topics

- [Panoramica](/it/knowledge-base/compliance/overview.md)
- [Panoramica dell'onboarding individuale](/it/knowledge-base/individual-onboarding/overview.md)
- [Stato e workflow KYC](/it/knowledge-base/individual-onboarding/status-and-workflow.md)
- [Governance e ruoli](/it/knowledge-base/compliance/governance-retention-and-privacy.md)
- [Livelli di verifica KYC](/it/knowledge-base/individual-onboarding/verification-levels.md)
