Qué pasa después de enviar el pedido
- Revisamos el pedido. Miramos tu sistema de caja, cuántos locales vas a conectar y para qué vas a usar la API, y te escribimos al email que dejaste.
- Recibís un comercio de pruebas (sandbox). Tiene su propia clave y datos de prueba precargados, separado por completo de comercios y clientes reales, para que pruebes el flujo completo sin riesgo.
- Integrás el flujo de la caja. Consultar saldo por cédula, teléfono o QR; registrar la venta con el ticket como clave; canjear puntos o premios; y anular o devolver, total o parcial.
- Pasás a producción con el comercio. La clave de producción es por comercio: el comercio la pide desde su panel (Configuración → Integraciones → API), Bonuxo la aprueba y el comercio la ve una sola vez. Puede tener varias, por ejemplo una por caja, para revocarlas por separado.
Qué conviene tener resuelto antes de integrar
- Una referencia única por venta (el número de ticket), que la caja reenvía igual en cada reintento: así una venta repetida nunca acredita puntos dos veces.
- Qué hace la caja si la API no responde. La venta nunca se frena: se cobra igual y los puntos se acreditan después. Si la caja estuvo sin conexión, las ventas se pueden cargar hasta 30 días hacia atrás con su fecha real.
- El canje sí espera confirmación. A diferencia de la venta, un canje de puntos necesita la respuesta de Bonuxo antes de aplicar el descuento en el ticket.
- El código de cada sucursal, porque las operaciones de escritura identifican dónde ocurrió la venta o el canje.
El panorama general de la API está en Developers y la conexión con sistemas ya integrados, en Integraciones.
¿Preferís mandarnos un mail directamente? Escribinos a contacto@bonuxo.com.
Siguientes pasos
Mientras tanto
También te puede servir
Cómo se pide y se aprueba la clave, cuántas podés tener y cómo se indica la sucursal.
Que la venta nunca se frene: reintentos sin duplicar, carga diferida y canjes confirmados.
¿Ya tenés cuenta? Hacelo ahora en Configuración → Integraciones → API.
Abrir en tu panel: Configuración → Integraciones → API