# Solicitá acceso a la API de Bonuxo.

> Fuente: https://bonuxo.com/developers/acceso
> Pedí tu clave de prueba para integrar la API POS de Bonuxo: contanos tu sistema de caja y para qué la vas a usar. Guía oficial 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.

## 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](https://bonuxo.com/developers) y la conexión con sistemas ya integrados, en [Integraciones](https://bonuxo.com/integraciones).

¿Preferís mandarnos un mail directamente? Escribinos a [contacto@bonuxo.com](mailto:contacto@bonuxo.com?subject=Acceso%20a%20la%20API%20POS%20de%20Bonuxo&body=Empresa%3A%0AContacto%3A%0AEmail%3A%0APa%C3%ADs%3A%0ASistema%20de%20caja%20o%20plataforma%3A%0ACantidad%20de%20locales%3A%0APara%20qu%C3%A9%20la%20vamos%20a%20usar%3A%0A).
