Ir al contenido
StampyWalletDocs
API y webhooks / Referencia / Entregar una recompensa

Entregar una recompensa

POST /v1/recompenses marca como entregada una recompensa ganada por un cliente, desde tu TPV.

POST/v1/recompenses

Marca una recompensa ganada como entregada al cliente, el equivalente al botón «Entregada» del escáner. La tarjeta del cliente se actualiza en su Wallet.

Cuerpo (JSON)

clientobjectobligatorio
El cliente: uno de id, carte, email o telephone.
recompense_idstringopcional
El UUID de la recompensa que entregar (en etat.recompenses_disponibles del objeto cliente). Por defecto: la pendiente más antigua.
pistestringopcional
normal o premium (el segundo contador): sin recompense_id, la pendiente más antigua de ese contador.

Ejemplo

curl
curl https://app.stampywallet.com/v1/recompenses \
  -H "Authorization: Bearer sw_live_votre_cle" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: recompense-ticket-0057" \
  -d '{"client": {"carte": "X7k2pQ9mLw"}}'

Respuesta

200 OK
{
  "recompense": {
    "id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab",
    "libelle": "Un café gratis",
    "piste": "normal",
    "offerte_le": "2026-10-22T09:25:00.000Z"
  },
  "client": { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "etat": { "recompenses_disponibles": [] } }
}

Sin recompensa que entregar, la respuesta es 409 con el código aucune_recompense.

Actualizado el

¿Te ha sido útil esta página?