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

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

{
"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": {

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.