Anular una visita
DELETE /v1/passages/:id retira la última visita de un cliente, por ejemplo tras un ticket anulado o reembolsado en caja.
/v1/passages/:idRetira una visita, con los permisos de un encargado: se quitan los sellos o puntos que puso, y una recompensa que hubiera desbloqueado desaparece con ella. :id es el UUID devuelto por POST /v1/passages.
Cuerpo opcional: { "motif": "Ticket anulado" } (o ?motif= en la dirección). Por defecto, el motivo es «API».
Ejemplo
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": "Ticket reembolsado"}'Respuesta
{
"annule": true,
"recompenses_retirees": 1,
"client": { "id": "c2a91f3e-7d40-4b8a-a3c5-91e0d6f4b2c7", "prenom": "Léa", "etat": { "tampons": 9, "objectif": 10 } }
}Los rechazos
Como en el mostrador, solo se puede anular la última visita de un cliente, y nunca dos veces.
| Estado | code | Cuándo |
|---|---|---|
404 | passage_introuvable | La visita no existe en este comercio |
409 | pas_dernier | No es la última visita del cliente |
409 | deja_annule | La visita ya está anulada |
409 | recompense_offerte | La recompensa desbloqueada por esta visita ya se ha entregado (la respuesta lleva un campo recompense) |
Actualizado el