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

# Destinatarios y destinos

> Crea un destinatario de terceros y el endpoint bancario o de cartera que recibe un pago.

Usa una cuenta del cliente cuando el cliente sea el propietario del endpoint. Usa un destinatario y un destino cuando otra persona o empresa reciba los fondos.

El destinatario registra quién recibe los fondos. El destino registra dónde los recibe.

## 1. Crea el destinatario

Crea un individuo o empresa con [`POST /v3/customers/{customerId}/recipients`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients). Envía estas cabeceras:

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

Incluye la dirección antes de crear un destino fiat. Guarda el `data.id` del destinatario devuelto como `RECIPIENT_ID` y conserva su estado actual.

## 2. Añade un destino

Crea el endpoint con [`POST /v3/customers/{customerId}/recipients/{recipientId}/destinations`](/api-reference/recipients/post-v3-customers-by-customer-id-recipients-by-recipient-id-destinations). Utiliza una nueva clave para este destino previsto:

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

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

Usa `self_custodied` únicamente cuando el destinatario controle la cartera. Sigue la variante actual de la Referencia de la API cuando la cartera esté en manos de otro custodio.

Guarda el `data.id` del destino devuelto como `DESTINATION_ID` y conserva su estado actual.

## 3. Espera a que el destino esté listo

Lee [`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) antes de crear una cotización.

Continúa solo cuando el estado actual del destino permita el pago y su moneda, método y red coincidan con el movimiento previsto. Los estados del destinatario y del destino son independientes.

Utiliza el ID de destino `dst_` en la cotización del pago. El ID de destinatario `rcp_` identifica el registro del propietario y no es un destino de cotización.

A continuación, lleva el destino listo a [Enviar fondos](/es/integration/send-funds).


## Related topics

- [Métodos de pago](/es/knowledge-base/compliance/payment-methods.md)
- [Enviar fondos](/es/integration/send-funds.md)
- [Flujos comunes](/es/integration/common-flows.md)
- [Puesta en producción](/es/integration/go-live.md)
- [Cuentas y carteras](/es/integration/accounts.md)