Configurar Bre-B en Merez: llave, QR y WhatsApp

Bre-B en Merez no es una pasarela: es tu llave cobrando. El checkout muestra tu llave o tu QR, el cliente paga desde la app de su banco y, al tocar «Ya pagué», te escribe por WhatsApp con el mensaje que definas. El dinero entra directo a tu cuenta y la confirmación la haces tú contra tu extracto.

Qué necesitas antes de empezar

• El módulo Pedidos activo en tu sitio. La configuración de Bre-B vive en Ajustes → Integraciones → Bre-B, y el checkout que la usa es el de Pedidos.
• Una llave Bre-B registrada en tu banco. Se crea en la zona Bre-B de la app o la sucursal virtual de la entidad donde tienes la cuenta. Los tipos de llave son: número de documento, número de celular, correo electrónico, identificador alfanumérico que empieza por @ y, para comercios, el código de establecimiento que asigna la entidad. No todas las entidades ofrecen todos los tipos al mismo tiempo.
• Un número de WhatsApp que atiendas. Es el canal por el que te va a llegar el aviso de pago. Va con indicativo del país, por ejemplo 573001112233.
• Alguien pendiente de la cuenta. La conciliación es manual: si nadie mira el extracto, el pedido se queda en Pago por verificar para siempre.
• Permisos. Solo un propietario del sitio puede abrir y guardar esta pantalla.

Las credenciales, una por una

Bre-B no usa llaves de API ni credenciales secretas: usa datos que el cliente necesita ver para poder pagarte. Por eso el formulario es corto.

Hay un cuarto texto que no es credencial pero cambia la experiencia: las instrucciones para el cliente en el checkout. Ahí puedes explicar en dos líneas qué hacer, por ejemplo «escanea el QR o usa la llave y luego toca Ya pagué». Aparecen debajo de la llave.

Bre-B no confirma el pago. Merez no habla con tu banco ni consulta tu cuenta: lo que dispara la revisión es el aviso por WhatsApp y lo que la cierra es tu extracto. Ningún estado de un pedido cambia solo porque entró plata.

Simulación de uso: de la plataforma a Merez

La misma venta de $80.000, ahora con Bre-B.

1. El cliente arma el pedido y elige Bre-B. En el checkout ve tu llave, el QR si lo subiste, las instrucciones y el monto exacto: $80.000.
2. Paga desde su banco. Abre la zona Bre-B de su entidad, pone la llave o escanea el QR, escribe el monto y confirma. Según el Banco de la República, el dinero llega en segundos y se puede pagar cualquier día y a cualquier hora.
3. Toca «Ya pagué». Merez marca el pedido como Pago por verificar, guarda la fecha y la referencia si el cliente escribió una, y abre WhatsApp con el mensaje ya redactado hacia tu número. El cliente solo pulsa enviar.
4. Tú revisas. Abres tu banco, buscas el abono de $80.000, comparas la hora y el nombre de quien pagó, y en Pedidos pulsas Verificar pago. El pedido queda en Verificado. Si no entró la plata o el monto no cuadra, pulsas Rechazar.
5. Despachas. Con el pedido en Verificado sale la entrega, y cuando ya está en manos del cliente pulsas Marcar entregado.

En el panel ves el pedido con su número, su total y su estado. Lo que no vas a ver es una confirmación automática: Merez no compara el valor que el cliente declaró con el que entró a tu cuenta. Esa comparación la haces tú, con el extracto abierto al lado.

Qué cambia exactamente el estado del pedido

El botón «Ya pagué» es el que mueve el pedido de Nuevo a Pago por verificar; el que lo cierra eres tú con Verificar pago. Si el cliente pagó y nunca tocó el botón, el pedido se queda en Nuevo y el panel no te habilita la verificación: tendrás que pedirle que lo toque. Y ojo con el orden: un pedido rechazado no se puede revivir, y uno verificado no se puede volver a verificar.

Cómo comprobar que quedó bien

1. Guarda la llave, el WhatsApp con indicativo y el mensaje, y deja la integración activa. Sin llave no hay Bre-B en el checkout, aunque el QR esté cargado.
2. Haz un pedido de bajo monto desde tu propio celular y revisa que el checkout muestre la llave y, si lo subiste, el QR y las instrucciones.
3. Paga de verdad desde tu banco a tu propia llave. Es la única prueba que vale: el dinero se mueve entre tus cuentas y el costo, si lo hay, lo define tu entidad.
4. Toca «Ya pagué». El pedido tiene que quedar en Pago por verificar y tiene que abrirse WhatsApp con el mensaje, ya con el número, el total y el nombre reemplazados.
5. Compara el abono en tu extracto y pulsa Verificar pago. Después pulsa Marcar entregado y confirma que el pedido recorrió los tres estados.
6. Prueba el caso triste: un pedido donde no pagas. No debe cambiar de estado por su cuenta, y el mensaje de WhatsApp no debe salir si no tocas el botón.

Errores frecuentes

Límites y buenas prácticas

• La conciliación es manual, sin excepción. Merez no consulta tu banco, no confirma el pago y no cierra el pedido solo. El estado Verificado lo pones tú, y eso es una decisión de producto, no una falla.
• El aviso de WhatsApp no es prueba de pago. Cualquiera puede tocar «Ya pagué» sin haber pagado. Verifica el extracto, no el mensaje, y desconfía si el monto o el nombre no coinciden.
• Comisión. Bre-B no pasa por una pasarela y Merez no descuenta nada del valor del pedido. Lo que cobre tu entidad por recibir, por el producto o por el plan que tengas depende de tu banco: revisa la tarifa vigente antes de calcular tu margen.
• Tope por transacción. El Banco de la República fija un máximo de 1.000 unidades de valor básico por operación, que para 2026 son $12.110.000, y tu entidad puede imponer topes menores. Merez no parte un pedido en varios pagos, así que un pedido por encima de tu tope se cobra por fuera del checkout.
• Reversos. Merez no reversa ni reembolsa. Si hay que devolver la plata, se hace desde tu entidad y se registra a mano; el pedido se rechaza o se ajusta aparte.
• Una llave por punto de venta si tu banco lo permite. Así sabes de qué sede vino cada abono y la conciliación deja de ser un rompecabezas.
• La llave no es una contraseña. Se comparte a propósito para que te paguen, pero no sirve para entrar a tu banca. El Banco de la República insiste en que la llave no es la clave y en que no hay que aceptar transacciones ni descargar aplicaciones por ese motivo.
• Lo que Merez no hace con Bre-B: no genera el QR (lo entrega tu banco), no confirma el pago, no concilia, no parte pagos y no cobra con tarjeta por esta vía.
• Cuando el volumen crece. Revisar el extracto pedido por pedido funciona con pocas ventas al día. Cuando se vuelve el cuello de botella de la operación, conviene encender una pasarela automática como Wompi y dejar Bre-B para lo que no admite espera.