> ## 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 et portefeuilles

> Choisissez le compte détenu par le client ou la ressource émise requise par un flux de fonds.

Chaque compte appartient à un client. Choisissez-le selon deux dimensions : qui le gère et s'il s'agit d'un portefeuille ou d'un compte bancaire.

## Choisir un compte

| Compte                  | À utiliser pour                                                                                                              |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Portefeuille émis       | Détenir un solde de stablecoin sous garde, financer un paiement, recevoir un encaissement ou régler un compte bancaire émis. |
| Compte bancaire émis    | Fournir au client des coordonnées bancaires réutilisables qui règlent dans un portefeuille émis.                             |
| Portefeuille externe    | Enregistrer une adresse blockchain détenue par le client.                                                                    |
| Compte bancaire externe | Enregistrer un compte bancaire détenu par le client pour un paiement propre.                                                 |

`issued` signifie que Swipelux crée et gère la ressource. `external` enregistre un endpoint détenu par le client. Un endpoint tiers relève d'un [destinataire et d'une destination](/fr/integration/recipients), pas de la liste des comptes du client.

<h2 id="create-the-account">
  Créer le compte
</h2>

Utilisez [`POST /v3/customers/{customerId}/accounts`](/api-reference/accounts/post-v3-customers-by-customer-id-accounts). Envoyez ces en-têtes avec l'un des corps de requête ci-dessous :

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

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

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

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

  <Tab title="Compte bancaire externe">
    ```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>

Utilisez uniquement les devises, réseaux, méthodes et types de compte renvoyés pour le client et la capacité actuels. Ne copiez pas la disponibilité d'un autre client ou environnement.

## Attendre que le compte soit utilisable

Stockez `data.id`, `data.status` et `data.openTaskIds` depuis la réponse de création. Lisez le dernier compte avec [`GET /v3/customers/{customerId}/accounts/{accountId}`](/api-reference/accounts/get-v3-customers-by-customer-id-accounts-by-account-id) avant de créer un devis de transfert ou d'afficher les coordonnées bancaires.

Utilisez le compte uniquement lorsque son statut actuel autorise la prochaine opération. Si des IDs de tâche sont ouverts, complétez-les via [Capacités et tâches](/fr/integration/onboarding/capabilities-and-requirements).

Un compte bancaire émis peut renvoyer `details: null` pendant le provisionnement. Présentez les coordonnées bancaires uniquement après qu'une lecture actuelle a renvoyé l'ensemble complet. Si `details.referenceRequired` est true, affichez exactement la `details.reference` avec les coordonnées bancaires.

## Garder les rôles de compte explicites

Pour un paiement, le portefeuille émis est la source dans `in.accountId`. Un compte bancaire détenu par le client est le `destinationId`. Pour un compte bancaire émis, `settlement.accountId` est le portefeuille émis qui reçoit les dépôts appariés.

Ensuite, utilisez un compte prêt dans [Recevoir des fonds](/fr/integration/receive-funds), [Envoyer des fonds](/fr/integration/send-funds), ou [Émettre un compte bancaire](/fr/integration/issue-bank-account).


## Related topics

- [Architecture du portefeuille et paiements](/fr/knowledge-base/compliance/custody-and-wallet-controls.md)
- [Vue d'ensemble](/fr/knowledge-base/compliance/overview.md)
- [Émettre un compte bancaire](/fr/integration/issue-bank-account.md)
- [Devis et transferts](/fr/integration/quotes-and-transfers.md)
- [Flux courants](/fr/integration/common-flows.md)