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

# Comptes i carteres

> Escull el compte propietat del client o el recurs emès requerit per un flux de diners.

Cada compte pertany a un client. Escull-lo utilitzant dues dimensions: qui el gestiona i si és una cartera o un compte bancari.

## Escull un compte

| Compte                | Utilitza'l per                                                                                                         |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Cartera emesa         | Mantenir un saldo custodial en stablecoin, finançar un pagament, rebre un cobrament o liquidar un compte bancari emès. |
| Compte bancari emès   | Donar al client dades bancàries reutilitzables que liquiden en una cartera emesa.                                      |
| Cartera externa       | Registrar una adreça de blockchain propietat del client.                                                               |
| Compte bancari extern | Registrar un compte bancari propietat del client per a un pagament propi.                                              |

`issued` significa que Swipelux crea i gestiona el recurs. `external` registra un punt final propietat del client. Un punt final de tercers pertany a un [destinatari i destinació](/ca/integration/recipients), no a la llista de comptes del client.

<h2 id="create-the-account">
  Crea el compte
</h2>

Utilitza [`POST /v3/customers/{customerId}/accounts`](/api-reference/accounts/post-v3-customers-by-customer-id-accounts). Envia aquestes capçaleres amb un dels cossos de sol·licitud següents:

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

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

  <Tab title="Compte bancari emès">
    ```json theme={null}
    {
      "origin": "issued",
      "type": "bank",
      "method": "ach",
      "country": "US",
      "currency": "USD",
      "settlement": {
        "accountId": "${SETTLEMENT_WALLET_ID}"
      },
      "label": "USD account"
    }
    ```
  </Tab>

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

  <Tab title="Compte bancari extern">
    ```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>

Utilitza només monedes, xarxes, mètodes i tipus de compte retornats per al client i la capacitat actuals. No copiïs la disponibilitat d'un altre client o entorn.

## Espera que el compte sigui utilitzable

Emmagatzema `data.id`, `data.status` i `data.openTaskIds` de la resposta de creació. Llegeix l'últim compte amb [`GET /v3/customers/{customerId}/accounts/{accountId}`](/api-reference/accounts/get-v3-customers-by-customer-id-accounts-by-account-id) abans de cotitzar una transferència o mostrar dades bancàries.

Utilitza el compte només quan el seu estat actual permeti la següent operació. Si hi ha IDs de tasca oberts, completa'ls mitjançant [Capacitats i tasques](/ca/integration/onboarding/capabilities-and-requirements).

Un compte bancari emès pot retornar `details: null` mentre es provisiona. Presenta les dades bancàries només després que una lectura actual retorni el conjunt complet. Si `details.referenceRequired` és true, mostra la `details.reference` exacta amb les coordenades bancàries.

## Manté els rols de compte explícits

Per a un pagament, la cartera emesa és l'origen a `in.accountId`. Un compte bancari propietat del client és el `destinationId`. Per a un compte bancari emès, `settlement.accountId` és la cartera emesa que rep els dipòsits coincidents.

A continuació, utilitza un compte preparat a [Rebre fons](/ca/integration/receive-funds), [Enviar fons](/ca/integration/send-funds) o [Emetre un compte bancari](/ca/integration/issue-bank-account).


## Related topics

- [Arquitectura de carteres i pagaments](/ca/knowledge-base/compliance/custody-and-wallet-controls.md)
- [Emet un compte bancari](/ca/integration/issue-bank-account.md)
- [Informació general](/ca/knowledge-base/compliance/regulatory-perimeter.md)
- [Visió general](/ca/knowledge-base/compliance/overview.md)
- [Proves de sandbox](/ca/integration/sandbox.md)