Saltar al contenido principal
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:
Request headers
Request body
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. Swipelux ignora los campos que el esquema de la solicitud no define, así que el texto no se guardaría. 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:
Request headers
Los destinos Pix y Pix Safe reciben BRL y necesitan la capacidad Pix lista del cliente (pix_pooled). Un destino Pix paga a una clave Pix: un CPF o CNPJ solo con dígitos, un número de teléfono como +55 seguido de 10 u 11 dígitos, un correo electrónico o una clave aleatoria. Un destino Pix Safe paga a una cuenta bancaria brasileña identificada por el CPF o CNPJ del titular en taxId, el código ISPB de 8 dígitos del banco en bankCode, la sucursal y el número de cuenta con su dígito de control. Las respuestas y los webhooks devuelven taxId enmascarado salvo sus últimos cuatro dígitos. Swipelux valida los identificadores bancarios, como IBAN, BIC, números de ruta ABA y números CPF o CNPJ, incluidas sus sumas de verificación, cuando creas un destino bancario. Los valores con formato incorrecto devuelven 400 validation_error. Estas comprobaciones solo confirman el formato, no que la cuenta exista ni quién es su titular. 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.