Consultar Pago
Visión General
Este endpoint recupera información detallada de un pago Bre-B específico mediante su identificador único (payment_id). Incluye metadatos como: Estado del pago, dirección (OUTGOING / INCOMING), monto, destinatario, fechas de creación y actualización.
Detalles del Endpoint
| Parámetro | Descripción |
|---|---|
| Endpoint | https://api.paas.sandbox.co.passportfintech.com/v1/payments/:payment_id |
| Método | GET |
| Encabezados | Content-Type: application/json, Authorization |
| Autenticación | Token de Acceso (Bearer Token) |
Cuerpo de la Solicitud
- No requiere cuerpo de solicitud.
Ejemplo de Solicitud
2
2
curl --location 'https://api.paas.sandbox.co.passportfintech.com/v1/payments/d0d9f17a1-af37-4e4d-831d-3520b5797aa1' \--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \Cuerpo de la Respuesta
- Código HTTP: 200 OK
Ejemplo de Respuesta
52
52
{ "receiver": { "account": { "account_number": "88509775041", "account_type": "ORDINARY" }, "key": { "key_type": "PHONE", "key_value": "3975999158" }, "participant": { "identification_number": "123456789" }, "owner": { "identification_number": "862886878", "identification_type": "NIT", "type": "BUSINESS", "name": "Merchant CWSPZ" } }, "direction": "OUTBOUND", "error": { "error_description": "B002", "error_code": "B002" }, "qr_code_reference": "", "sender": { "account": { "account_number": "88509775041", "account_type": "ORDINARY" }, "participant": { "identification_number": "123456789" }, "owner": { "identification_number": "862886878", "identification_type": "NIT", "type": "BUSINESS", "name": "Merchant CWSPZ" } }, "amount": { "value": "100000", "currency": "COP" }, "account_id": "a9a0e0f7-0263-44ee-911e-d66910f9f5c7", "created_at": "2025-10-10T08:52:05.171Z", "resolution_id": "9e5cd615-d2da-43eb-866e-c0026b177c01", "updated_at": "2025-10-10T08:52:13.570Z", "status": "REJECTED", "id": "0d9f17a1-af37-4e4d-831d-3520b5797aa1"}Errores Comunes y Manejo
| Código HTTP | Significado | Descripción |
|---|---|---|
| 400 | Bad Request | payment_id malformado o solicitud inválida. |
| 401 | Unauthorized | Token Bearer ausente, expirado o sin alcance paas.core.breb_payments.get. |
| 403 | Forbidden | El solicitante no tiene permisos para obtener este pago. |
| 404 | Not Found | No existe un pago con el payment_id proporcionado. |
| 500 | Server Error | Error inesperado en el servidor; reintente o contacte soporte. |
Buenas Prácticas
- Registra siempre los campos
id, status y reference al consultar un pago, para efectos de conciliación y trazabilidad. - Combínalo con Listar Pagos para monitorear operaciones por lotes o transacciones de múltiples clientes.