Besuch stornieren
DELETE /v1/passages/:id entfernt den letzten Besuch eines Kunden, zum Beispiel nach einem stornierten oder erstatteten Bon an der Kasse.
/v1/passages/:idEntfernt 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 -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
{
"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) |