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/besuch-stornieren.md (oder mit dem Header Accept: text/markdown).

StampyWalletDocs
API und Webhooks / Referenz / Besuch stornierenAls Markdown ansehen

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 zurückgibt.

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

Beispiel

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

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.

StatuscodeWann
404passage_introuvableDer Besuch existiert in diesem Geschäft nicht
409pas_dernierEs ist nicht der letzte Besuch des Kunden
409deja_annuleDer Besuch ist bereits storniert
409recompense_offerteDie durch diesen Besuch freigeschaltete Prämie wurde bereits eingelöst (die Antwort enthält ein Feld recompense)
War diese Seite hilfreich?