Preguntas frecuentes
Las consultas más comunes del equipo de Customer Success durante integraciones de Yappy en Caja.
¿Necesito tener internet en mi caja para usar Yappy en Caja?
Sí. La caja se comunica con la API de Yappy en tiempo real para generar QR y consultar estados. Sin internet, no podrás cobrar. Se recomienda tener un plan de contingencia (WiFi de respaldo o datos móviles) para evitar interrupciones.
¿Cuánto cuesta cada transacción?
La comisión es 1% más ITBMS sobre el monto de cada transacción. Comisión mínima de $0.02. El monto se acredita completo a tu cuenta y la comisión se debita una sola vez al día por el total acumulado.
¿Puedo tener múltiples cajas abiertas al mismo tiempo?
Sí. Cada unidad de cobro (caja) tiene su propia sesión independiente. Puedes tener tantas cajas abiertas simultáneamente como unidades de cobro hayas creado en tu grupo. Cada una tiene su propio token de sesión.
¿Qué pasa si se va la luz o el internet mientras el cliente está pagando?
La transacción sigue en pie del lado de Yappy. Cuando se restaure la conectividad, consulta el estado con GET /transaction/{id}. Si el cliente pagó durante el corte, el estado será COMPLETED. Si no pagó y la ventana de 5 minutos expiró, estará en CANCELLED.
¿El token de sesión se renueva automáticamente?
No. El token dura 8 horas desde la apertura de la sesión. Si tu turno de caja es más largo, cierra y reabre la sesión antes de que expire. Monitorea el tiempo de apertura en tu sistema para gestionar la renovación proactivamente.
¿Puedo usar el mismo QR estático en múltiples cajas?
No. Cada QR estático está asociado a una unidad de cobro específica. Cada caja tiene su propio QR descargado desde Yappy Comercial.
¿Qué pasa si cancelo una transacción y el cliente ya había pagado?
Si el cliente ya pagó (estado COMPLETED), el endpoint PUT /transaction/{id} ejecuta una anulación (reverso) en lugar de una cancelación. El dinero regresa al cliente. Por eso es importante verificar el estado antes de llamar al endpoint.
¿Puedo integrar Yappy en Caja en una app móvil para vendedores a domicilio?
Sí. La API de Yappy en Caja funciona desde cualquier cliente HTTP. Puedes integrarla en una app Android/iOS para cobros en campo. Considera usar QR estático impreso en una tarjeta para facilitar la operación sin necesidad de mostrar un QR en pantalla del dispositivo.
¿A quién contacto si tengo un problema técnico?
Tu primer punto de contacto es tu Customer Success Officer asignado. Para soporte técnico general, escribe a botondepagoyappy@bgeneral.com con: nombre del comercio, descripción del problema, y si aplica, el transactionId o el código de error recibido.