Beneficios que puede comprar

Los beneficios que un cliente puede comprar con los puntos que tiene.

GET/v1/clients/{client_code}/available-benefitsAPI key del comercio

Busca los beneficios disponibles para un cliente: los que se le muestran en su panel de beneficios, es decir los que puede comprar con sus puntos.

Es la contracara de beneficios comprados, que trae los que ya canjeó puntos por ellos.

Parámetros

client_codestringpathrequerido

El código del cliente.

Respuesta

Un array de Beneficio.

curl https://loybox-public-api-752998171300.southamerica-west1.run.app/v1/clients/12345/available-benefits \
  -H "Authorization: Bearer $LOYBOX_API_KEY"
// 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 cost de cada beneficio es lo que cuesta en puntos. Para saber cuáles le alcanzan, comparalo con el points de obtener un cliente.

Errores

CódigoCuándo
404El cliente no existe.
422El código no tiene un formato válido.