Skip to main content
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:
relationship describe la relación entre el destinatario y tu cliente. Elige un valor del esquema de solicitud de POST /v3/customers/{customerId}/recipients. Si envías other, no añadas un campo de texto libre; el esquema rechaza los campos desconocidos. 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:
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.