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

Developers · Primeros pasos

Autenticación: una clave por comercio.

La API POS se usa con una clave que el comercio pide desde su panel y Bonuxo aprueba. Acá está cómo se consigue, cuántas puede haber y qué más identifica cada operación.

Última actualización:


Cómo se consigue la clave

  1. El comercio entra a su panel, en Configuración → Integraciones → API, y toca «Solicitar acceso a la API».
  2. Completa para qué la va a usar, el sistema de caja o integrador, el contacto técnico y la cantidad de locales.
  3. Bonuxo revisa la solicitud. En los dos casos —aprobada o rechazada— le llega un mail al email de notificación del admin.
  4. Si se aprueba, el comercio ve su clave una sola vez, con «Ver mi clave». Si se rechaza, ve el motivo y puede volver a pedirla.

La clave se muestra una sola vez. Guardala en un lugar seguro del sistema de caja apenas la veas: no queda visible en el panel para consultarla después.

La clave es del comercio, no de la sucursal

Un comercio puede tener varias claves —por ejemplo, una por caja— y revocarlas por separado. Se pide una por vez: mientras haya una solicitud pendiente, no se abre otra.

El registro de llamadas a la API lo ve sólo el soporte de Bonuxo, no el comercio.

Cada escritura indica la sucursal

Las operaciones de escritura (registrar una venta, un canje) identifican además en qué sucursal ocurrieron. La caja puede mandar el código de la sucursal o su nombre.

Nombre del localCódigo que genera Bonuxo
Palermo Sohopalermo-soho

El código lo genera Bonuxo solo, a partir del nombre del local, y no cambia si después se renombra.

Entorno de prueba o de producción

Cada clave declara su entorno: de prueba o de producción. Bonuxo valida que la clave y el comercio sean del mismo entorno antes de aceptar cualquier operación, así una clave de pruebas nunca toca clientes reales.

¿Buscás el detalle técnico? Headers, formatos y códigos de error están en la referencia técnica, disponible para comercios con acceso aprobado.

Siguientes pasos

Seguí con la integración

Tu siguiente paso

Sandbox de la API

Con la clave de prueba, integrá contra el comercio de pruebas sin tocar datos reales.

También te puede servir

  • Buenas prácticas para la caja

    Que la venta nunca se frene: reintentos sin duplicar, carga diferida y canjes confirmados.

  • Sucursales

    Dónde se cargan los locales cuyo código usa cada escritura de la API.

¿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.