Prämie einlösen
POST /v1/recompenses markiert eine verdiente Prämie eines Kunden als eingelöst, direkt aus Ihrer Kasse.
/v1/recompensesMarkiert eine verdiente Prämie als an den Kunden übergeben, das Gegenstück zur Schaltfläche „Eingelöst“ im Scanner. Die Karte des Kunden aktualisiert sich in seinem Wallet.
Body (JSON)
id, carte, email oder telephone.etat.recompenses_disponibles des Kundenobjekts). Standardmäßig: die älteste fällige.normal oder premium (der zweite Zähler): ohne recompense_id die älteste fällige Prämie dieser Spur.Beispiel
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"}}'Antwort
{
"recompense": {
"id": "504c8734-3bbd-4fe9-95f8-7a67c8239dab",
"libelle": "Ein Kaffee gratis",
"piste": "normal",
"offerte_le": "2026-10-22T09:25:00.000Z"
},
"client": { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "etat": { "recompenses_disponibles": [] } }
}Gibt es keine Prämie einzulösen, lautet die Antwort 409 mit dem Code aucune_recompense.