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

# Recipients en destinations

> Maak een derde-partij-recipient en het bank- of walleteindpunt dat een uitbetaling ontvangt.

Gebruik een klantrekening wanneer de klant het eindpunt bezit. Gebruik een recipient en destination wanneer een andere persoon of bedrijf het geld ontvangt.

De recipient registreert wie het geld ontvangt. De destination registreert waar zij het ontvangen.

## 1. Maak de recipient aan

Maak een individu of bedrijf aan met [`POST /v3/customers/{customerId}/recipients`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients). Verstuur deze headers:

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

Voeg het adres toe voordat je een fiat-destination aanmaakt. Bewaar de geretourneerde recipient `data.id` als `RECIPIENT_ID` en behoud de huidige status.

## 2. Voeg een destination toe

Maak het eindpunt aan met [`POST /v3/customers/{customerId}/recipients/{recipientId}/destinations`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients-by-recipient-id-destinations). Gebruik een nieuwe key voor deze beoogde destination:

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

<Tabs>
  <Tab title="Bank-destination">
    ```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="Wallet-destination">
    ```json theme={null}
    {
      "type": "wallet",
      "currency": "USDC",
      "ownership": {
        "type": "self_custodied"
      },
      "details": {
        "network": "base",
        "address": "0x1111111111111111111111111111111111111111"
      }
    }
    ```
  </Tab>
</Tabs>

Gebruik `self_custodied` alleen wanneer de recipient de wallet beheert. Volg de huidige API Reference-variant wanneer de wallet door een andere custodian wordt gehouden.

Bewaar de geretourneerde destination `data.id` als `DESTINATION_ID` en behoud de huidige status.

## 3. Wacht op destination-readiness

Lees [`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) voordat je een quote aanmaakt.

Ga alleen verder wanneer de huidige destination-status de uitbetaling toestaat en de valuta, methode en netwerk overeenkomen met de beoogde beweging. Recipient- en destination-statussen zijn onafhankelijk.

Gebruik de `dst_` destination-ID in de uitbetalingsquote. De `rcp_` recipient-ID identificeert het eigenaarsrecord en is geen quote-destination.

Neem de ready destination vervolgens mee naar [Geld versturen](/nl/integration/send-funds).


## Related topics

- [Migreren naar v3](/nl/api-reference/versioning/migrate-to-v3.md)
- [Accounts en wallets](/nl/integration/accounts.md)
- [Quotes en transfers](/nl/integration/quotes-and-transfers.md)
- [Geld versturen](/nl/integration/send-funds.md)
- [Go-live](/nl/integration/go-live.md)