# Besuch stornieren

> 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/besuch-stornieren/

DELETE /v1/passages/:id entfernt den letzten Besuch eines Kunden, zum Beispiel nach einem stornierten oder erstatteten Bon an der Kasse.

`DELETE /v1/passages/:id`

Entfernt einen Besuch, mit den Rechten eines Managers: Die damit vergebenen Stempel oder Punkte werden abgezogen, und eine Prämie, die er freigeschaltet hatte, verschwindet mit ihm. `:id` ist die UUID, die [`POST /v1/passages`](https://stampywallet.com/de/docs/api/besuch-erfassen/) zurückgibt.

Optionaler Body: `{ "motif": "Bon storniert" }` (oder `?motif=` in der Adresse). Standardmäßig lautet der Grund „API“.

## Beispiel

```bash title="curl"
curl -X DELETE https://app.stampywallet.com/v1/passages/226fdea1-ba59-49fb-93e6-60a14a765134 \
  -H "Authorization: Bearer sw_live_votre_cle" \
  -H "Content-Type: application/json" \
  -d '{"motif": "Bon erstattet"}'
```

## Antwort

```json title="200 OK"
{
  "annule": true,
  "recompenses_retirees": 1,
  "client": { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "etat": { "tampons": 9, "objectif": 10 } }
}
```

## Ablehnungen

Wie an der Theke lässt sich nur der **letzte** Besuch eines Kunden stornieren, und nie zweimal.

| Status | `code` | Wann |
|---|---|---|
| `404` | `passage_introuvable` | Der Besuch existiert in diesem Geschäft nicht |
| `409` | `pas_dernier` | Es ist nicht der letzte Besuch des Kunden |
| `409` | `deja_annule` | Der Besuch ist bereits storniert |
| `409` | `recompense_offerte` | Die durch diesen Besuch freigeschaltete Prämie wurde bereits eingelöst (die Antwort enthält ein Feld `recompense`) |
