Beneficios comprados
Los beneficios que un cliente ya compró y todavía puede canjear, con el código de canje de cada uno.
Trae los beneficios que el cliente ya compró con sus puntos y todavía puede canjear en el comercio.
Es la contracara de beneficios que puede comprar: ahí van los que le alcanzan con sus puntos, acá los que ya son suyos.
De acá sale el código de canje
El client_benefit_code de cada item es el código que se usa para
consultar el beneficio y para
canjearlo. Es el número que el cliente
presenta en el local o pega en el checkout.
Parámetros
client_codestringpathrequeridoEl código del cliente.
usedboolean | nullquerySin especificar trae sólo los canjeables: sin usar y sin vencer. true
trae los ya canjeados y false los no canjeados, en ambos casos sin filtrar
por vencimiento.
El comportamiento por defecto es el que sirve para operar: mostrarle al cliente
qué puede usar hoy. El parámetro used es para consultar el historial.
Respuesta
Un array de Beneficio canjeable.
curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/clients/12345/benefits \
-H "Authorization: Bearer $LOYBOX_API_KEY"// 200 OK
[
{
"client_benefit_code": 887766,
"issue_date": "2026-03-01T14:22:00Z",
"due_date": "2026-04-01T14:22: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
}
}
]Errores
| Código | Cuándo |
|---|---|
401 | La API key es inválida: no tiene un comercio asociado. |
404 | El cliente no existe. |
422 | El código no tiene un formato válido, o used no es un booleano. |