Pagos

Pagos es el módulo que cobra sin que nadie mire un comprobante: el cliente paga en una pasarela y el pedido se verifica solo. Su clave en el catálogo es cobros, aunque el panel lo llame Pagos automáticos. No es Wompi: Wompi es un riel dentro del módulo, y mañana puede haber otro.

Qué hace

• Registra rieles de cobro. Los automáticos abren una sesión de pago y reciben un webhook. El manual (Bre-B) no abre sesión y lo confirma una persona.
• Distingue pedido de cobro. El pedido es el documento de venta; el cobro es el riel que lo cobra solo, sin que nadie revise un comprobante.
• Confirma con tres guardas: firma del evento, referencia MRZ-{sitio}-{pedido} y monto al centavo. Si el monto no cuadra, no verifica: deja un aviso en el log.
• Es idempotente: un pedido ya verificado ignora el evento repetido, así que un reintento del webhook no cobra ni entrega dos veces.
• Modo pruebas y producción con dos juegos de llaves bajo la misma fila. El modo decide cuál se usa y el riel no lo sabe: lee siempre las credenciales resueltas.
• Los sitios internos lo traen encendido, que es con lo que Merez se cobra a sí misma el alta de plan y las recargas.

De qué depende

• El módulo cobros y las credenciales de la pasarela en Ajustes → Integraciones: llave pública, llave privada, secreto de integridad y secreto de eventos. Se guardan cifradas y por sitio.
• Un pedido que cobrar: el riel se engancha al checkout del módulo Pedidos.
• El webhook público, alcanzable desde fuera.
• Bre-B no depende de este módulo: su configuración es del sitio y vive en Pedidos.

Qué pasa cuando se apaga

• Abrir un cobro automático responde 403 con el mensaje del módulo; el sitio sigue cobrando por Bre-B, que es manual.
• Pero la lista de métodos disponibles y las instrucciones no consultan el módulo: el checkout puede ofrecer la pasarela y luego negarla al confirmar. La pantalla promete lo que el backend rechaza.
• Y el pedido ya quedó grabado en estado nuevo antes de ese 403: no se corrompe, pero se queda huérfano de la pasarela.
• Los cobros por Bre-B los sigue verificando una persona.

Límites y trampas

• Una guarda que rechaza todo se ve igual que “nadie paga”. Ya pasó: el webhook leía el sello de tiempo de donde no estaba y rechazaba todos los eventos sin que nadie lo notara. Hoy no hay alerta por volumen de firmas inválidas.
• Cambiar a producción sin cambiar las llaves deja el checkout cobrando contra el sandbox.
• No hay rotación de credenciales guardadas, y una llave pegada no se puede volver a leer: si cambias la del proveedor, se pega la nueva.
• La conciliación de Bre-B es manual: Merez no confirma el pago con el banco.
• La IA no puede marcar un pago. Sus herramientas no incluyen ninguna de pago: si el cliente dice que pagó, lo anota y sugiere revisarlo.

Ver también

• Pedidos
• Cotizaciones
• Integraciones