Ir al contenido
StampyWalletDocs
API y webhooks / Referencia / Anular una visita

Anular una visita

DELETE /v1/passages/:id retira la última visita de un cliente, por ejemplo tras un ticket anulado o reembolsado en caja.

DELETE/v1/passages/:id

Retira 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
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

200 OK
{
  "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.

EstadocodeCuándo
404passage_introuvableLa visita no existe en este comercio
409pas_dernierNo es la última visita del cliente
409deja_annuleLa visita ya está anulada
409recompense_offerteLa recompensa desbloqueada por esta visita ya se ha entregado (la respuesta lleva un campo recompense)

Actualizado el

¿Te ha sido útil esta página?