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

# Destinataris i destinacions

> Crea un destinatari de tercers i el punt final bancari o de cartera que rep un pagament.

Utilitza un compte de client quan el client sigui propietari del punt final. Utilitza un destinatari i una destinació quan una altra persona o negoci rebi els fons.

El destinatari registra qui rep els fons. La destinació registra on els rep.

## 1. Crea el destinatari

Crea un individu o negoci amb [`POST /v3/customers/{customerId}/recipients`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients). Envia aquestes capçaleres:

```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"
}
```

Inclou l'adreça abans de crear una destinació fiat. Emmagatzema el `data.id` del destinatari retornat com a `RECIPIENT_ID` i conserva el seu estat actual.

## 2. Afegeix una destinació

Crea el punt final amb [`POST /v3/customers/{customerId}/recipients/{recipientId}/destinations`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients-by-recipient-id-destinations). Utilitza una nova clau per a aquesta destinació prevista:

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

<Tabs>
  <Tab title="Destinació bancària">
    ```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="Destinació de cartera">
    ```json theme={null}
    {
      "type": "wallet",
      "currency": "USDC",
      "ownership": {
        "type": "self_custodied"
      },
      "details": {
        "network": "base",
        "address": "0x1111111111111111111111111111111111111111"
      }
    }
    ```
  </Tab>
</Tabs>

Utilitza `self_custodied` només quan el destinatari controli la cartera. Segueix la variant actual de la referència de l'API quan la cartera estigui en mans d'un altre custodi.

Emmagatzema el `data.id` de la destinació retornada com a `DESTINATION_ID` i conserva el seu estat actual.

## 3. Espera la preparació de la destinació

Llegeix [`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) abans de crear una cotització.

Continua només quan l'estat actual de la destinació permeti el pagament i la seva moneda, mètode i xarxa coincideixin amb el moviment previst. Els estats del destinatari i de la destinació són independents.

Utilitza l'ID de destinació `dst_` a la cotització del pagament. L'ID de destinatari `rcp_` identifica el registre del propietari i no és una destinació de cotització.

A continuació, porta la destinació preparada a [Enviar fons](/ca/integration/send-funds).


## Related topics

- [Enviar fons](/ca/integration/send-funds.md)
- [Anar en producció](/ca/integration/go-live.md)
- [Quickstart](/ca/integration/quickstart.md)
- [Mètodes de pagament](/ca/knowledge-base/compliance/payment-methods.md)
- [Compliment de la Travel Rule](/ca/knowledge-base/compliance/travel-rule.md)