Clientes
Consultar los clientes del comercio, sus puntos y los beneficios que pueden comprar o ya compraron.
Un cliente es una persona sumada al club del comercio. Tiene un
client_code, un saldo de puntos y un historial propios.
Esta sección es de sólo lectura: sirve para mostrar el estado de un cliente en tu sistema: en la pantalla de caja, en el perfil de la tienda online, en un CRM. Los puntos se mueven registrando consumos y canjeando beneficios, no desde acá.
Los dos listados de beneficios
Hay dos endpoints de beneficios por cliente y conviene no confundirlos:
| Endpoint | Qué trae |
|---|---|
/available-benefits | Los que el cliente puede comprar con los puntos que tiene |
/benefits | Los que ya compró y todavía puede canjear, cada uno con su código |
Listar clientes
El listado completo del comercio, paginado.
Obtener un cliente
Un cliente por su código, con su saldo de puntos.
Beneficios que puede comprar
El catálogo que le alcanza con los puntos que tiene.
Beneficios comprados
Los que ya compró, con el código de canje de cada uno.
Credencial
Toda la sección va desde tu servidor, con la API key del comercio:
Authorization: Bearer {api-key}Devuelve datos de todos tus clientes
Estos endpoints exponen nombre, email y puntos de las personas del club. No los llames desde el frontend: si necesitás que el propio usuario vea sus datos, para eso está Mi cuenta, que sólo muestra lo suyo.