Beneficios que puedo comprar
El catálogo de beneficios vigentes del comercio que el usuario puede comprar con sus puntos.
Catálogo de beneficios vigentes del comercio, que el usuario puede comprar con sus puntos.
Para saber cuáles le alcanzan, comparar el cost de cada beneficio con los
points de GET /v1/me. La API no filtra
por saldo: devuelve el catálogo y la UI decide qué mostrar como alcanzable y qué
como "te faltan N puntos".
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/me/benefits/available \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-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
}
]El id de cada item es lo que se manda como benefit_id a
comprar un beneficio.
Sin login, el mismo catálogo es público
Para mostrarle el catálogo a un visitante que todavía no inició sesión hay
GET /v1/public/benefits, que no necesita
token.
Errores
| Código | Cuándo |
|---|---|
401 | El token de acceso falta, venció o no corresponde a un usuario final. |
422 | Falta el header X-Commerce-Id. |