Mis beneficios
Los beneficios que el usuario ya compró y todavía puede canjear, con su código.
GET/v1/me/benefitsToken del usuario
Beneficios que el usuario ya compró con sus puntos en este comercio y todavía puede canjear.
El client_benefit_code de cada item es el código que el usuario presenta en el
comercio para canjearlo.
Headers
X-Commerce-IdintegerheaderrequeridoId del comercio que integra la API. Todas las respuestas quedan limitadas a este comercio.
Respuesta
Un array de Beneficio canjeable.
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me/benefits \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "X-Commerce-Id: 87"// 200 OK
[
{
"client_benefit_code": 887766,
"issue_date": "2026-08-24T13:05:00Z",
"due_date": "2026-09-23T13:05:00Z",
"used": false,
"benefit": {
"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": null,
"tiendanube_coupon": null
}
}
]El código es el cupón
En una tienda online, el client_benefit_code es lo que el usuario pega en el
checkout. Conviene mostrarlo grande y con un botón de copiar, y al lado el
due_date para que sepa hasta cuándo lo puede usar.
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. |