Skip to content
StampyWalletDocs
API and webhooks / Reference / Give a reward

Give a reward

POST /v1/recompenses marks a reward earned by a customer as given, from your POS.

POST/v1/recompenses

Marks an earned reward as handed to the customer, the equivalent of the scanner's "Given" button. The customer's card updates in their Wallet.

Body (JSON)

clientobjectrequired
The customer: one of id, carte, email or telephone.
recompense_idstringoptional
The UUID of the reward to give (in etat.recompenses_disponibles of the customer object). By default: the oldest one due.
pistestringoptional
normal or premium (the second counter): without recompense_id, the oldest one due on that track.

Example

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

Response

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

With no reward to give, the response is 409 with the code aucune_recompense.

Updated

Was this page helpful?