Qué permite
Consultar saldo
Ver los puntos disponibles de un cliente por cédula, teléfono o el QR de su tarjeta, antes de cobrar.
Registrar ventas
Acreditar puntos por cada venta, usando el ticket como clave: reintentar la misma venta nunca duplica los puntos.
Anular o devolver
Revertir una venta completa, o una devolución parcial (incluso por unidades vendidas, para indumentaria y rubros similares).
Canjear puntos o premios
Usar los puntos como medio de pago, o canjear un premio del catálogo del comercio, con un código para el ticket.
Guías para integrar
Lo que necesitás saber antes de escribir la primera línea, en tres páginas cortas:
- Autenticación
Cómo se pide y se aprueba la clave, cuántas podés tener y cómo se indica la sucursal.
- Sandbox
Un comercio de pruebas con su clave y datos propios, separado de los reales.
- Buenas prácticas
Que la venta nunca se frene: reintentos sin duplicar, carga diferida y canjes confirmados.
Esta página es un panorama general, no la referencia técnica completa. El detalle exacto de cada operación (campos, formatos, códigos de error) está en la referencia técnica, disponible para comercios con acceso aprobado. Ver /developers/referencia.
Cómo conseguir acceso
Pedí tu clave de prueba desde /developers/acceso: contanos tu sistema de caja o plataforma, cuántos locales tenés y para qué la vas a usar. Te respondemos con acceso al entorno de pruebas.
Preguntas frecuentes
¿Esta API sirve para cualquier sistema de caja?
Sí. Está pensada para que la integre cualquier sistema de punto de venta propio, sin depender de que Bonuxo tenga una integración lista de antemano.
¿Qué pasa si mi caja no tiene conexión en el momento de la venta?
La caja puede seguir vendiendo con normalidad y registrar la venta más tarde, indicando la fecha real en que ocurrió, hasta 30 días hacia atrás.
¿Puedo probar antes de integrar contra producción?
Sí, hay un entorno de pruebas (sandbox) separado, con su propia clave y datos de prueba.
¿Cómo consigo acceso?
Pedilo desde /developers/acceso, contándonos tu sistema de caja y para qué la vas a usar. Te respondemos con una clave de prueba.
Siguientes pasos
Para empezar a integrar
También te puede servir
API POS públicaPlus
Conectá tu propia caja: consultá saldo, sumá puntos y canjeá premios por API.
WebhooksPlus
Tu sistema recibe un aviso firmado cada vez que pasa algo en el programa.
¿Ya tenés cuenta? Hacelo ahora en Configuración → Integraciones → API.
Abrir en tu panel: Configuración → Integraciones → API