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

# Destinataires et destinations

> Créez un destinataire tiers et l'endpoint bancaire ou de portefeuille qui reçoit un paiement.

Utilisez un compte client lorsque le client détient l'endpoint. Utilisez un destinataire et une destination lorsqu'une autre personne ou entreprise reçoit les fonds.

Le destinataire enregistre qui reçoit les fonds. La destination enregistre où ils les reçoivent.

## 1. Créer le destinataire

Créez un individu ou une entreprise avec [`POST /v3/customers/{customerId}/recipients`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients). Envoyez ces en-têtes :

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

```json theme={null}
{
  "type": "individual",
  "relationship": "contractor",
  "firstName": "Jason",
  "lastName": "Swipelux",
  "email": "jason@swipelux.com",
  "phone": "+14155551234",
  "address": {
    "streetLine1": "1 Market Street",
    "city": "San Francisco",
    "state": "CA",
    "postalCode": "94105",
    "country": "US"
  },
  "label": "Jason contractor"
}
```

Incluez l'adresse avant de créer une destination fiat. Stockez le `data.id` du destinataire renvoyé en tant que `RECIPIENT_ID` et conservez son statut actuel.

## 2. Ajouter une destination

Créez l'endpoint avec [`POST /v3/customers/{customerId}/recipients/{recipientId}/destinations`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients-by-recipient-id-destinations). Utilisez une nouvelle clé pour cette destination prévue :

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

<Tabs>
  <Tab title="Destination bancaire">
    ```json theme={null}
    {
      "type": "ach",
      "currency": "USD",
      "details": {
        "routingNumber": "021000021",
        "accountNumber": "123456789",
        "accountType": "checking",
        "bankName": "Example Bank",
        "accountHolderName": "Jason Swipelux",
        "country": "US"
      }
    }
    ```
  </Tab>

  <Tab title="Destination portefeuille">
    ```json theme={null}
    {
      "type": "wallet",
      "currency": "USDC",
      "ownership": {
        "type": "self_custodied"
      },
      "details": {
        "network": "base",
        "address": "0x1111111111111111111111111111111111111111"
      }
    }
    ```
  </Tab>
</Tabs>

Utilisez `self_custodied` uniquement lorsque le destinataire contrôle le portefeuille. Suivez la variante actuelle de la Référence API lorsque le portefeuille est détenu par un autre dépositaire.

Stockez le `data.id` de la destination renvoyée en tant que `DESTINATION_ID` et conservez son statut actuel.

## 3. Attendre la disponibilité de la destination

Lisez [`GET /v3/customers/{customerId}/recipients/{recipientId}/destinations/{destinationId}`](/api-reference/recipients/get-v3-customers-by-customer-id-recipients-by-recipient-id-destinations-by-destination-id) avant de créer un devis.

Continuez uniquement lorsque le statut actuel de la destination autorise le paiement et que sa devise, sa méthode et son réseau correspondent au mouvement prévu. Les statuts de destinataire et de destination sont indépendants.

Utilisez l'ID de destination `dst_` dans le devis de paiement. L'ID de destinataire `rcp_` identifie l'enregistrement du propriétaire et n'est pas une destination de devis.

Ensuite, apportez la destination prête à [Envoyer des fonds](/fr/integration/send-funds).


## Related topics

- [Migrer vers v3](/fr/api-reference/versioning/migrate-to-v3.md)
- [Envoyer des fonds](/fr/integration/send-funds.md)
- [Comptes et portefeuilles](/fr/integration/accounts.md)
- [Flux courants](/fr/integration/common-flows.md)
- [Mise en production](/fr/integration/go-live.md)