Saltar al contenido principal
BonuxoCentro de ayudaIngresarProbar 14 días gratis

Developers · Acceso

Solicitá acceso a la API de Bonuxo.

Contanos tu sistema de caja o plataforma y para qué la vas a usar. Te respondemos con una clave de prueba para el entorno de sandbox.

Última actualización:


Qué pasa después de enviar el pedido

  1. 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.
  2. 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.
  3. 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.
  4. 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

Tu siguiente paso

Sandbox de la API

Mientras esperás la respuesta, mirá qué vas a poder probar en el sandbox.

También te puede servir

¿Ya tenés cuenta? Hacelo ahora en Configuración → Integraciones → API.

Abrir en tu panel: Configuración → Integraciones → API
Escribí al menos 2 letras.

Preguntale a Nux

Contesta sólo con lo que dice esta documentación y te muestra de qué página sale cada respuesta.