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
2
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.
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_iddentro del cuerpo del Pago.