> ## 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.

# Clienti

> Crea l'individuo o l'azienda che possiede capability, conti e transfer.

Crea il cliente prima di costruire un pay-in, un payout o un conto bancario emesso. Capability, conti e transfer hanno come scope quel cliente. Usa `externalId` come mapping stabile verso il record corrispondente nel tuo sistema.

```bash theme={null}
export API_BASE='https://platform.swipelux.com'
export SWIPELUX_API_KEY='replace-with-your-api-key'
```

<h2 id="individual-customers">
  Clienti individuali
</h2>

Un individuo richiede solo `type`. Includi i campi del profilo che gia' conosci e aggiungine altri solo quando la capability o il task corrente ne ha bisogno.

Crea il cliente con [`POST /v3/customers`](/api-reference/customers/post-v3-customers):

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-user-123" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "individual",
  "externalId": "user_123",
  "individual": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

Salva il `data.id` restituito come `CUSTOMER_ID`. Consulta [Onboarding individuale](/it/knowledge-base/individual-onboarding/overview) per il contesto di policy.

<h2 id="business-customers">
  Clienti business
</h2>

Un business richiede `business.legalName`. Crea il business con la stessa operazione:

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: customer-company-456" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "type": "business",
  "externalId": "company_456",
  "business": {
    "legalName": "Acme Payments SAS"
  }
}
JSON
```

Salva il `data.id` restituito come `CUSTOMER_ID`. Consulta [Onboarding business](/it/knowledge-base/business-onboarding/overview) per il contesto di policy e documenti.

## Aggiungi related party del business

Aggiungi director, owner e altri partecipanti aziendali quando sono noti o richiesti. Questo esempio crea un director con [`POST /v3/customers/{customerId}/related-parties`](/api-reference/customers/post-v3-customers-by-customer-id-related-parties):

```bash theme={null}
curl --request POST \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}/related-parties" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}" \
  --header "Idempotency-Key: related-party-director-001" \
  --header "Content-Type: application/json" \
  --data @- <<'JSON'
{
  "partyType": "person",
  "roles": ["director"],
  "title": "Chief executive officer",
  "person": {
    "firstName": "Amina",
    "lastName": "Diallo",
    "residenceCountry": "FR"
  }
}
JSON
```

Salva il `data.id` restituito come `RELATED_PARTY_ID`.

## Leggi la readiness dalle capability

Un cliente non ha uno stato di verifica o di readiness nell'API. Leggi il cliente con [`GET /v3/customers/{customerId}`](/api-reference/customers/get-v3-customers-by-customer-id) per ottenere i dati di profilo correnti, quindi usa le capability e i loro `openTaskIds` per decidere cosa il cliente puo' fare successivamente.

```bash theme={null}
curl --request GET \
  "${API_BASE}/v3/customers/${CUSTOMER_ID}" \
  --header "X-API-Key: ${SWIPELUX_API_KEY}"
```

Successivamente, prosegui su [Capability e task](/it/integration/onboarding/capabilities-and-requirements) per scoprire e attivare il risultato di prodotto di cui hai bisogno.


## Related topics

- [Limiti di transazione](/it/knowledge-base/compliance/transaction-limits.md)
- [Capability e task](/it/integration/onboarding/capabilities-and-requirements.md)
- [Panoramica dell'integrazione](/it/integration/overview.md)
- [Panoramica dell'onboarding individuale](/it/knowledge-base/individual-onboarding/overview.md)
- [Panoramica dell'onboarding business](/it/knowledge-base/business-onboarding/overview.md)