Zum Inhalt springen

Für KI-Agenten: Das Verzeichnis der Dokumentation steht unter https://stampywallet.com/de/docs/llms.txt, die gesamte Dokumentation in einer Datei unter https://stampywallet.com/de/docs/llms-full.txt, und diese Seite gibt es als Markdown: https://stampywallet.com/de/docs/api/praemie-einloesen.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
API und Webhooks / Referenz / Prämie einlösenAls Markdown ansehen

Prämie einlösen

POST /v1/recompenses markiert eine verdiente Prämie eines Kunden als eingelöst, direkt aus Ihrer Kasse.

POST /v1/recompenses

Markiert 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)

client
object
erforderlich
Der Kunde: eines von id, carte, email oder telephone.
recompense_id
string
optional
Die UUID der einzulösenden Prämie (in etat.recompenses_disponibles des Kundenobjekts). Standardmäßig: die älteste fällige.
piste
string
optional
normal oder premium (der zweite Zähler): ohne recompense_id die älteste fällige Prämie dieser Spur.

Beispiel

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

Antwort

200 OK
{
  "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.

War diese Seite hilfreich?