Guía de integración POS

La API usa una clave Bearer por integración. La clave solo se muestra una vez y se almacena como hash.

Flujo recomendado

1. Crea una integración en Avanzado → Integración POS.
2. Implementa POST /api/v1/pos/transactions con un externalId estable.
3. Envía importes en unidades menores y moneda ISO de tres letras.
4. Usa REFUNDED o VOIDED con el mismo externalId para compensar la visita.
5. Consulta el estado y concilia cualquier evento sin cliente o sucursal resoluble.

La creación automática de clientes está desactivada por defecto. Cuando se activa, el perfil nace sin consentimiento de marketing.

La especificación pública vigente está en Lealtia POS OpenAPI.