# Prämie einlösen

> Für KI-Agenten: Das vollständige Verzeichnis der Dokumentation steht unter [llms.txt](https://stampywallet.com/de/docs/llms.txt), die gesamte Dokumentation passt in eine Datei: [llms-full.txt](https://stampywallet.com/de/docs/llms-full.txt). Seite online: https://stampywallet.com/de/docs/api/praemie-einloesen/

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](https://stampywallet.com/de/docs/api/kunden-abrufen/#objet)). 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

```bash title="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

```json title="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`.
