Destinatarios y destinos

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. Envía estas cabeceras:

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-create-001
Content-Type: application/json

{
  "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. Utiliza una nueva clave para este destino previsto:

X-API-Key: ${SWIPELUX_API_KEY}
Idempotency-Key: recipient-destination-create-001
Content-Type: application/json

Destino bancario
Destino de cartera

{
  "type": "ach",
  "currency": "USD",
  "details": {
    "routingNumber": "021000021",
    "accountNumber": "123456789",
    "accountType": "checking",
    "bankName": "Example Bank",
    "accountHolderName": "Jason Swipelux",
    "country": "US"
  }
}

{
  "type": "wallet",
  "currency": "USDC",
  "ownership": {
    "type": "self_custodied"
  },
  "details": {
    "network": "base",
    "address": "0x1111111111111111111111111111111111111111"
  }
}

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

Comienza

Incorpora clientes

Crea flujos de dinero

Lanzamiento

Destinatarios y destinos

1. Crea el destinatario

2. Añade un destino

3. Espera a que el destino esté listo

​1. Crea el destinatario

​2. Añade un destino

​3. Espera a que el destino esté listo

1. Crea el destinatario

2. Añade un destino

3. Espera a que el destino esté listo