Integración con Yappy para cobrar en línea y en mostrador

La forma rápida de integrar un botón de pago es dejar que el navegador avise: el cliente paga, la página recibe una respuesta y le dice al servidor «este pedido ya está pagado». Funciona en la demo.

El problema es que todo lo que ocurre en el navegador lo controla quien está del otro lado. Cualquiera con la consola del navegador abierta puede mandar ese mismo aviso sin haber pagado, y el sistema le va a creer, porque le pidió permiso a la parte equivocada.

La forma correcta es que el pedido solo cambie a pagado cuando el propio banco se lo confirma al servidor, por un canal aparte que el cliente no toca. El navegador puede mostrar «gracias por tu compra» todo lo que quiera; el estado real lo decide el servidor cuando recibe y verifica esa confirmación.

• la confirmación se verifica en el servidor, nunca en el navegador
• el pedido no pasa a pagado porque el cliente diga que pagó
• cada aviso se procesa una sola vez, aunque el banco lo reintente
• el monto confirmado se compara contra el monto del pedido

La primera es el botón de pago en línea: el cliente arma su pedido en tu tienda o en tu sistema, elige Yappy, paga desde su app del banco y vuelve. El pedido queda registrado con su comprobante y su estado, sin que nadie transcriba nada.

La segunda es el cobro en mostrador: quien atiende genera el cobro desde el punto de venta y el cliente paga ahí mismo. Sirve para el negocio que vende presencial y en línea con el mismo inventario, que es el caso más común y el que peor resuelven los sistemas de estante.

En los dos casos el pago queda amarrado al pedido, no anotado aparte. Esa es la diferencia entre tener Yappy y tener Yappy integrado.

Necesitas una cuenta comercial habilitada con Banco General y las credenciales de comercio que el banco entrega. Ese trámite lo haces tú con el banco — nosotros no pedimos ni manejamos tus credenciales bancarias por chat ni por correo.

Del lado técnico, la integración se monta en funciones aisladas del resto del sistema, de modo que un cambio en la lógica de cobro no puede tumbar el catálogo ni la facturación. Las credenciales se guardan como secretos del servidor y nunca se envían al navegador.

• credenciales solo del lado del servidor, nunca en el código del navegador
• lógica de cobro aislada del resto del sistema
• registro de cada intento de pago para poder auditar después

Al terminar tienes el cobro por Yappy dentro de tu sistema, con el estado de cada pedido reflejando la realidad, un registro de cada intento de pago, y la conciliación resuelta: puedes cruzar lo que dice el sistema contra lo que dice el banco sin revisar el celular de nadie.

Si además llevas facturación electrónica, el pago confirmado es lo que dispara la emisión del documento fiscal. Las dos piezas se hablan.