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)

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

JSON
    
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'
Copy

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

JSON
    
 
{    "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"}
Copy

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.

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

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