# La API pública para conectar tu caja a Bonuxo.

> Fuente: https://bonuxo.com/developers
> Documentación pública de la API POS de Bonuxo: qué permite, casos de uso, autenticación, sandbox y buenas prácticas. Guía oficial Bonuxo.

Documentación general de la API POS de Bonuxo: para el equipo técnico de un sistema de punto de venta que quiere integrar la fidelización de sus comercios directamente desde la caja.

## 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](https://bonuxo.com/developers/autenticacion)
    
    Cómo se pide y se aprueba la clave, cuántas podés tener y cómo se indica la sucursal.
    
-   [Sandbox](https://bonuxo.com/developers/sandbox)
    
    Un comercio de pruebas con su clave y datos propios, separado de los reales.
    
-   [Buenas prácticas](https://bonuxo.com/developers/buenas-practicas)
    
    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](https://bonuxo.com/developers/referencia).

## Cómo conseguir acceso

Pedí tu clave de prueba desde [/developers/acceso](https://bonuxo.com/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.