Skip to main content
Todas las llamadas a la API pública se autentican con una API key que va en el header x-api-key.
No hay OAuth ni tokens que expiren: la misma key sirve indefinidamente hasta que la revoques.

​
Cómo obtener tu API key

1

Entrá al panel

Ingresá a mi.tiendadepuntos.com con tu usuario administrador.
2

Andá a Integraciones

En el menú, entrá a Configuración → Integraciones.
3

Copiá la key

Guardala en un lugar seguro apenas la generes.

​
La key identifica a tu comercio

La API key determina de qué comercio son los datos de cada llamada. No hace falta —ni se puede— mandar un identificador de comercio en el cuerpo de las llamadas: todo lo que consultes o modifiques queda acotado al comercio dueño de la key.
La API key da acceso completo al programa de fidelidad de tu comercio: puede acreditar puntos, suspender clientes y entregar canjes.Tratala como una contraseña: no la pongas en el código de una app móvil ni en JavaScript del navegador, donde cualquiera puede leerla. Usala solo desde tu backend, tu POS o tu ERP.

​
Trabajar por sucursal

Varios endpoints aceptan el header opcional x-branch-id para indicar en qué sucursal se está haciendo la operación:
Los IDs de tus sucursales salen de GET /external/branch. Si omitís el header, la operación queda registrada a nivel comercio, sin sucursal.
En POST /external/tags/add la sucursal no va por header: va en el campo branch_id del cuerpo.

​
Errores de autenticación

Los dos fallos de credencial son 401. El message los separa: header ausente contra key que no pertenece a ningún comercio. El 404 queda para cuando la key es válida y el recurso pedido no existe (Client not found, Level not found, PointsItem with id 12 not found).

​
Probar que funciona

El endpoint más liviano para verificar que tu key está bien configurada es el de sucursales, contra QA (https://apidev.tiendadepuntos.com):
Si devuelve la lista de tus sucursales, ya estás listo para el resto de la API.