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

JSON
    
 
curl --location 'https://api.paas.sandbox.co.passportfintech.com/v1/payments/d0d9f17a1-af37-4e4d-831d-3520b5797aa1' \
--header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
Copy

Cuerpo de la Respuesta

Código HTTP: 200 OK

Ejemplo de Respuesta

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

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.

Última actualización el