Qué resuelve
Fudo y Tiendanube ya se conectan solos porque Bonuxo lee sus ventas directamente. Pero si tu negocio tiene un sistema de caja propio, o uno que no está en esa lista, la API POS pública te permite conectar ese sistema vos mismo (o con quien lo desarrolla) para que la fidelización funcione igual desde tu propia caja.
Qué permite hacer
Consultar saldo
Ver los puntos de un cliente por cédula, teléfono o el QR de su tarjeta, antes de cobrar.
Sumar puntos por venta
Registrar cada venta con el ticket como referencia, de forma que reintentar nunca suma puntos de más.
Anular o devolver
Revertir una venta completa o una devolución parcial, incluso por unidades vendidas.
Canjear puntos o premios
Usar los puntos como medio de pago, o canjear un premio del catálogo, con un código para el ticket.
Cómo funciona, en general
Tu sistema se identifica con una clave propia del comercio y consulta o registra operaciones contra la API de Bonuxo. La venta nunca depende de que Bonuxo responda a tiempo: si la API no contesta, tu caja sigue cobrando con normalidad y la acreditación de puntos se reintenta después, sin duplicar nada gracias a la idempotencia por ticket. Hay un entorno de pruebas (sandbox) separado del real, para integrar y probar sin arriesgar datos de producción.
Para el detalle técnico completo — autenticación, formatos de request, códigos de error, reintentos — visitá /developers, la documentación pública para quien integra.
Cómo se activa, paso a paso
- 01
Pedí acceso
Desde /developers/acceso, contanos tu sistema de caja y para qué la vas a usar.
- 02
Recibí tu clave de prueba
Te llega una clave de entorno de pruebas (sandbox) para empezar a integrar.
- 03
Integrá y probá
Con la documentación técnica, tu sistema (o quien lo desarrolla) integra contra el sandbox.
- 04
Pasá a producción
Cuando esté probado, pedís tu clave real desde tu panel, en Configuración → Integraciones → API: nos contás para qué la vas a usar y quién hace la integración, la aprobamos y la ves una sola vez.
Plan
La API POS pública forma parte de las Integraciones, disponibles en los planes Plus y Enterprise.
Preguntas frecuentes
¿Sirve para cualquier sistema de caja?
Sí. A diferencia de Fudo o Tiendanube (que ya vienen conectados), la API POS pública es para cuando tenés tu propio sistema de punto de venta, o uno que todavía no tiene una integración lista con Bonuxo.
¿La venta se frena si Bonuxo no responde?
No. La API está pensada para que tu caja nunca dependa de Bonuxo para cobrar: si no hay respuesta a tiempo, cobrás igual y reintentás acreditar los puntos después, sin duplicar nada.
¿Puedo probar antes de integrar en serio?
Sí. Hay un entorno de pruebas (sandbox) separado de producción, con su propia clave, para integrar y probar sin tocar datos reales.
¿Qué pasa si mi caja estuvo sin conexión?
La API acepta cargar ventas de hasta 30 días hacia atrás, indicando la fecha real de la venta, para que los puntos se calculen igual que si se hubiera registrado en el momento.
Pedí acceso a la API y empezá a integrar.
14 días gratis, sin tarjeta de crédito.
Siguientes pasos
Para empezar a integrar
También te puede servir
Autenticación, sandbox y buenas prácticas para integrar la caja con Bonuxo.
PuntosPlus
Cómo suma puntos un cliente, para saber qué va a acreditar tu caja.
El catálogo que tu caja puede canjear por API.
¿Ya tenés cuenta? Hacelo ahora en Configuración → Integraciones → API.
Abrir en tu panel: Configuración → Integraciones → API