Recompensas

Listar recompensas

GET /api/v1/rewards

Parámetros de query

Parámetro	Tipo	Descripción
page	número	Página.
limit	número	Por página, máximo 100.
status	texto	Active o Inactive.
search	texto	Busca por nombre.

Ejemplo

curl "https://api.novity.com.ar/api/v1/rewards?status=Active" \
  -H "Authorization: Bearer nv_tu_api_key"

---

Obtener una recompensa

GET /api/v1/rewards/:rewardId

Ejemplo

curl https://api.novity.com.ar/api/v1/rewards/rew_abc123 \
  -H "Authorization: Bearer nv_tu_api_key"

---

Canjear una recompensa

Canjea una recompensa para un cliente. La API verifica que el cliente tenga puntos suficientes, los descuenta y registra el canje.

POST /api/v1/rewards/redeem

Cuerpo

Campo	Tipo	Descripción
customerId	texto	Obligatorio. ID del cliente.
productId	texto	Obligatorio. ID de la recompensa.
deliverNow	booleano	Si es true, entrega la recompensa de inmediato (método Manual).

Ejemplo

curl -X POST https://api.novity.com.ar/api/v1/rewards/redeem \
  -H "Authorization: Bearer nv_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "customerId": "cus_abc123",
    "productId": "rew_abc123",
    "deliverNow": true
  }'

Errores

Código	Mensaje
400	customerId y productId son requeridos
400	Puntos insuficientes. Disponible: X, requerido: Y