BReB — QR
POST
01 — 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.
POST
https://qrvbreb.vepay.com.co/api/auth/loginHeaders
| Header | Valor |
|---|---|
Content-Type | application/json |
Cuerpo de la petición
| Campo | Tipo | Descripción | Req. |
|---|---|---|---|
username | string | Usuario proporcionado por PaymentsWay. | Sí |
password | string | Contraseña proporcionada por PaymentsWay. | Sí |
{
// Username y Password que comparte Payments Way
"username": "",
"password": ""
}Ejemplo de petición
const res = await fetch('https://qrvbreb.vepay.com.co/api/auth/login', {
method : 'POST',
headers: { 'Content-Type': 'application/json' },
body : JSON.stringify({
username: 'TU_USUARIO',
password: 'TU_PASSWORD'
})
});
const { token } = await res.json();
// Guarda el token para usarlo en las demás llamadas
localStorage.setItem('breb_token', token);cURL
curl --location 'https://qrvbreb.vepay.com.co/api/auth/login' \
--header 'Content-Type: application/json' \
--data '{
"username": "",
"password": ""
}'Introducción
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.
POST02 — Generar QR
Genera un código QR siguiendo el estándar QR. Puedes crear QRs estáticos (11) para puntos de venta físicos o dinámicos (12) para cobros específicos con monto fijo.