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

# Conti e wallet

> Scegli il conto di proprieta' del cliente o la risorsa emessa richiesta da un flusso di denaro.

Ogni conto appartiene a un cliente. Sceglilo usando due dimensioni: chi lo gestisce e se e' un wallet o un conto bancario.

## Scegli un conto

| Conto                  | Usalo per                                                                                                                |
| ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Wallet emesso          | Detenere un saldo in stablecoin custoditi, finanziare un payout, ricevere un pay-in o regolare un conto bancario emesso. |
| Conto bancario emesso  | Fornire al cliente coordinate bancarie riutilizzabili che si regolano su un wallet emesso.                               |
| Wallet esterno         | Registrare un indirizzo blockchain di proprieta' del cliente.                                                            |
| Conto bancario esterno | Registrare un conto bancario di proprieta' del cliente per un payout di prima parte.                                     |

`issued` significa che Swipelux crea e gestisce la risorsa. `external` registra un endpoint di proprieta' del cliente. Un endpoint di terze parti va sotto una [recipient e destination](/it/integration/recipients), non nella lista dei conti del cliente.

<h2 id="create-the-account">
  Crea il conto
</h2>

Usa [`POST /v3/customers/{customerId}/accounts`](/api-reference/accounts/post-v3-customers-by-customer-id-accounts). Invia questi header con uno dei body di richiesta seguenti:

```http theme={null}
X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: account-create-001
Content-Type: application/json
```

<Tabs>
  <Tab title="Wallet emesso">
    ```json theme={null}
    {
      "origin": "issued",
      "type": "wallet",
      "currency": "USDC",
      "network": "base",
      "label": "Settlement wallet"
    }
    ```
  </Tab>

  <Tab title="Conto bancario emesso">
    ```json theme={null}
    {
      "origin": "issued",
      "type": "bank",
      "method": "ach",
      "country": "US",
      "currency": "USD",
      "settlement": {
        "accountId": "${SETTLEMENT_WALLET_ID}"
      },
      "label": "USD account"
    }
    ```
  </Tab>

  <Tab title="Wallet esterno">
    ```json theme={null}
    {
      "origin": "external",
      "type": "wallet",
      "currency": "USDC",
      "network": "polygon",
      "details": {
        "address": "0x4997b0a68bebc1b0d80a93567ba7002be92b8b11"
      },
      "label": "Customer Polygon wallet"
    }
    ```
  </Tab>

  <Tab title="Conto bancario esterno">
    ```json theme={null}
    {
      "origin": "external",
      "type": "bank",
      "methods": ["ach", "wire"],
      "country": "US",
      "currency": "USD",
      "details": {
        "routingNumber": "021000021",
        "accountNumber": "123456789",
        "accountType": "checking",
        "bankName": "Example Bank",
        "accountHolderName": "Acme Payments SAS"
      },
      "label": "Customer operating account"
    }
    ```
  </Tab>
</Tabs>

Usa solo valute, network, metodi e tipi di conto restituiti per il cliente e la capability correnti. Non copiare la disponibilita' da un altro cliente o ambiente.

## Attendi che il conto sia utilizzabile

Salva `data.id`, `data.status` e `data.openTaskIds` dalla risposta di creazione. Leggi l'ultimo conto con [`GET /v3/customers/{customerId}/accounts/{accountId}`](/api-reference/accounts/get-v3-customers-by-customer-id-accounts-by-account-id) prima di quotare un transfer o mostrare dettagli bancari.

Usa il conto solo quando il suo stato corrente consente l'operazione successiva. Se ci sono ID task aperti, completali tramite [Capability e task](/it/integration/onboarding/capabilities-and-requirements).

Un conto bancario emesso puo' restituire `details: null` durante il provisioning. Presenta i dettagli bancari solo dopo che una lettura corrente restituisce il set completo. Se `details.referenceRequired` e' true, mostra l'esatto `details.reference` insieme alle coordinate bancarie.

## Mantieni espliciti i ruoli del conto

Per un payout, il wallet emesso e' la sorgente in `in.accountId`. Un conto bancario di proprieta' del cliente e' il `destinationId`. Per un conto bancario emesso, `settlement.accountId` e' il wallet emesso che riceve i depositi accoppiati.

Successivamente, usa un conto ready in [Ricevi fondi](/it/integration/receive-funds), [Invia fondi](/it/integration/send-funds) o [Emetti un conto bancario](/it/integration/issue-bank-account).


## Related topics

- [Migrare a v3](/it/api-reference/versioning/migrate-to-v3.md)
- [Architettura wallet e payout](/it/knowledge-base/compliance/custody-and-wallet-controls.md)
- [Emetti un conto bancario](/it/integration/issue-bank-account.md)
- [Informazioni generali](/it/knowledge-base/compliance/regulatory-perimeter.md)
- [Clienti](/it/integration/onboarding/customers.md)