Resolver Destinatario

Visión General

Este endpoint permite recuperar los detalles de un Destinatario Bre-B específico en la API de Passport usando el ID único del destinatario. La respuesta incluye el tipo de llave del recipiente, valor de la llave y detalles de la entidad asociada.

Detalles del Endpoint

Definición	Descripción
Endpoint	https://api.paas.sandbox.co.passportfintech.com/v1/recipients/:recipient_id/resolve
Método	POST
Encabezados	Authorization
Autenticación	Token de Acceso (Bearer Token)

Información

Reemplaza recipient_id con el ID único real del destinatario.

Cuerpo de la Solicitud

No se requiere cuerpo en la solicitud para este endpoint.

Ejemplo de Solicitud

curl --location --request POST 'https://api.paas.sandbox.co.passportfintech.com/v1/recipients/daa209f9-fbdf-4f2b-aadc-db42fe16358c/resolve' \ --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Cuerpo de la Respuesta

Código HTTP: 200 OK
Retorna los datos de la cuenta asociada al cliente junto con su ID único.

Ejemplo de Respuesta

{ "owner": { "identification_number": "642349532", "business_name": "Merchant G60PG", "type": "BUSINESS", "identification_type": "NIT" }, "type": "BREB", "receptor_node": "VIS", "created_at": "2025-10-10T07:43:41.267Z", "updated_at": "2025-10-10T07:43:41.267Z", "customer_id": "31eb66c3-f309-48ce-8b12-086f9e76b84c", "resolution_id": "8ce7a3be-3043-4546-9a3f-281d7f8ba758", "participant": { "identification_number": "123456789" }, "account": { "account_number": "88758829529", "account_type": "ORDINARY" }, "last_resolved_at": "2025-10-10T08:24:33.462Z", "key": { "key_type": "PHONE", "key_value": "3975999158" }, "alias": "Pepito SAS5", "id": "daa209f9-fbdf-4f2b-aadc-db42fe16358c" }

La respuesta confirma los datos del destinatario y su asociación con una Llave Bre-B específica dentro del directorio central del Banco de la República.

Importante

El id que se genera en la respuesta es el resolution_id.

Asegúrese de reutilizar el resolution_id cuando vuelva a intentar realizar un pago. Esto es fundamental, ya que garantizamos que solo se creará un pago con el mismo resolution_id. En otras palabras, actúa como una clave de idempotencia, lo que garantiza que no se procesen pagos duplicados.

Errores comunes y Manejo

Código HTTP	Significado	Descripción
400 Bad Request	Solicitud inválida	Falta el ID del destinatario o tiene un formato incorrecto.
401 Unauthorized	Token expirado	El token de acceso es inválido o ha expirado.
403 Forbidden	Acceso denegado	La solicitud no está autorizada para recuperar este recipiente.
404 Not Found	Recipiente no encontrado	No se encontró un recipiente con el ID proporcionado.
500 Internal Server Error	Error del servidor	Ocurrió un error inesperado al recuperar el recipiente.

Mejores Prácticas

Asegúrate de proporcionar correctamente el ID del destinatario en la URL de la solicitud.
Usa los datos resueltos del recipiente para iniciar pagos Bre-B: pasa el resolution_id dentro del cuerpo del Pago.

Última actualización el