Mi nivel
El nivel actual del usuario, su multiplicador de puntos y qué le falta para el siguiente.
Nivel actual del usuario en este comercio, con su multiplicador de puntos, el progreso acumulado y cuál es el próximo nivel.
Headers
X-Commerce-IdintegerheaderrequeridoId del comercio que integra la API. Todas las respuestas quedan limitadas a este comercio.
Respuesta
Un objeto Nivel.
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/me/level \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "X-Commerce-Id: 87"// 200 OK
{
"name": "Plata",
"rank": 2,
"points_multiplier": 1.25,
"icon_url": "https://cdn.loybox.com.ar/levels/plata.png",
"reached_at": "2026-05-11T10:00:00Z",
"expiration_date": "2027-05-11T10:00:00Z",
"is_expired": false,
"next_level": {
"name": "Oro",
"rank": 3,
"threshold_type": "points",
"threshold": 5000
},
"total_earned_points": 3120,
"total_spent_amount": 312000,
"total_consumptions_count": 48
}Cómo armar la barra de progreso
El progreso se calcula contra el acumulado histórico, no contra el saldo. Según
el threshold_type del próximo nivel:
threshold_type | Compararlo con |
|---|---|
| Por puntos | total_earned_points |
| Por monto gastado | total_spent_amount |
Canjear no baja de nivel
El nivel se mide sobre el historial completo de la relación, así que gastar puntos baja el saldo pero nunca el nivel. Ver Cómo suben de nivel.
Errores
| Código | Cuándo |
|---|---|
401 | El token de acceso falta, venció o no corresponde a un usuario final. |
404 | El usuario todavía no tiene nivel asignado en este comercio, o el comercio no usa niveles. |
422 | Falta el header X-Commerce-Id. |
El 404 es el caso normal de un cliente nuevo
No lo trates como una falla. Cuando el usuario todavía no tiene nivel, o el comercio no usa niveles, corresponde esconder la sección de niveles en la UI, no mostrar un error.