Aller au contenu
StampyWalletDocs
API et webhooks / Référence / Offrir une récompense

Offrir une récompense

POST /v1/recompenses marque comme offerte une récompense gagnée par un client, depuis votre caisse.

POST/v1/recompenses

Marque une récompense gagnée comme remise au client, l'équivalent du bouton « Offert » du scanner. La carte du client se met à jour dans son Wallet.

Corps (JSON)

clientobjectrequis
Le client : un de id, carte, email ou telephone.
recompense_idstringfacultatif
L'UUID de la récompense à offrir (dans etat.recompenses_disponibles de l'objet client). Par défaut : la plus ancienne due.
pistestringfacultatif
normal ou premium (le second compteur) : sans recompense_id, la plus ancienne due de cette piste.

Exemple

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"}}'

Réponse

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

Sans récompense à offrir, la réponse est 409 avec le code aucune_recompense.

Mis à jour le

Cette page vous a aidé ?