# Autenticación: una clave por comercio.

> Fuente: https://bonuxo.com/developers/autenticacion
> Cómo se autentica la API POS de Bonuxo: una clave por comercio, solicitada desde el panel y aprobada por Bonuxo, con entorno de prueba. Guía oficial Bonuxo.

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.

## 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 local

Código que genera Bonuxo

Palermo Soho

`palermo-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](https://bonuxo.com/developers/referencia), disponible para comercios con acceso aprobado.