Catálogo de beneficios
Los beneficios vigentes del comercio, sin necesidad de token.
GET/v1/public/benefitsSin token
Beneficios vigentes del comercio, sin necesidad de token.
Sirve para mostrarle el programa de fidelidad a un visitante que todavía no inició sesión: es la vidriera de premios que responde "¿qué gano si me sumo?".
Headers
X-Commerce-IdintegerheaderrequeridoId del comercio que integra la API. Todas las respuestas quedan limitadas a este comercio.
Respuesta
Un array de Beneficio.
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/public/benefits \
-H "X-Commerce-Id: 87"// 200 OK
[
{
"id": "b_9f2a",
"type": "percentage_discount",
"description": "20% de descuento en toda la tienda",
"cost": 250,
"expiration": "2026-12-31T23:59:59Z",
"benefit_type": "normal",
"color": "#f1a10d",
"buy_limit": 0,
"prize": {
"type": "percentage_discount",
"title": "20% off",
"description": "Válido en toda la tienda",
"value": 20,
"product": null,
"expiration": "2026-12-31T23:59:59Z",
"image": null
},
"tiendanube_coupon": null
}
]Con sesión, usá el de Mi cuenta
Una vez logueado conviene usar
GET /v1/me/benefits/available,
que es el mismo catálogo pero ya filtrado por lo que el comercio habilitó para
ese usuario.
Errores
| Código | Cuándo |
|---|---|
400 | No se pudieron obtener los beneficios del comercio. |
422 | Falta el header X-Commerce-Id. |