BReB — QR
BReB — QR
BReB (Botón de Recaudo Bancario) es el estándar colombiano de pagos inmediatos QR impulsado por Banco de la República de Colombia. PaymentsWay lo implementa sobre la infraestructura de VePay / qrvbreb.vepay.com.co, cumpliendo el estándar QR. Permite recibir pagos desde cualquier app bancaria del ecosistema ACH.
Obtén el JWT para autenticar las demás llamadas.
Crea un QR estático o dinámico con datos del comercio.
Valida el token JWT del QR generado.
Consulta el estado actual de un QR por su ID.
Actualiza el estado de un QR (pagado, expirado, etc.).
Flujo completo QR
El siguiente diagrama muestra los 5 pasos del ciclo de vida de un QR BReB, desde el login hasta la confirmación del pago:
URL Base y autenticación
https://qrvbreb.vepay.com.coTodos los endpoints (excepto Login) requieren el header Authorization: Bearer {token} con el JWT obtenido en el paso 1.
Las credenciales de acceso (username y password) son proporcionadas por PaymentsWay. Contacta a tecnologia@paymentsway.co para habilitarlas.
Tipos de QR
| Tipo | Código | Descripción | Cuándo usarlo |
|---|---|---|---|
| Estático | 11 | Un solo QR permanente, sin monto fijo. | Punto de venta físico, vitrina, impreso. |
| Dinámico | 12 | QR por transacción con monto y referencia. | E-commerce, cobros específicos, facturas. |
Ecosistema compatible
POSTWebHook
Recibe notificaciones en tiempo real sobre el resultado de cada transacción. PaymentsWay hace un HTTP POST a tu endpoint cuando una transacción cambia de estado.
POST01 — Login
Autentícate con las credenciales entregadas por PaymentsWay para obtener el JWT Bearer token que necesitas en todas las demás llamadas. El token expira en 1 hora.