Remboursements & tickets

Numéros de ticket

Envoyez votre numéro de ticket comme receipt_ref sur chaque action d’un ticket (vente, récompense, paiement avec le solde…). Il doit être unique par commerce : si votre numérotation repart à zéro par caisse, préfixez-le (T1-000042). De 1 à 64 caractères imprimables, sans espaces.

Annuler un ticket

curl -X POST https://api.fidelia.se/pos/v1/receipts/T1-000042/reverse \
  -H "Authorization: Bearer $FIDELIA_KEY" \
  -H "Idempotency-Key: $(uuidgen)"

Tout ce que le ticket a fait sur les cartes Fidelia est annulé : tampons, points et cashback gagnés, solde utilisé (rendu), récompenses utilisées (de nouveau disponibles), articles de carnet utilisés. La réponse liste les cartes à jour.

Réponse	Signification
`200`	Fait (`reversed_actions` compte ce qui a été annulé).
`404 receipt_not_found`	Aucune action de carte de ce commerce n’a ce numéro de ticket : rien à faire.
`409 already_reversed`	Déjà fait.
`409 reverse_window_expired`	Plus de 24 heures : le commerce corrige la carte dans son tableau de bord Fidelia.
`409 reverse_conflict`	La carte a évolué : les points ou le crédit gagnés ont été dépensés depuis, ou la récompense a été utilisée. Le commerce corrige dans son tableau de bord.

Remboursements partiels : annulez tout le ticket, puis envoyez une nouvelle sale avec un nouveau receipt_ref pour ce que le client garde.

Qu’a fait un ticket ?

curl https://api.fidelia.se/pos/v1/receipts/T1-000042 -H "Authorization: Bearer $FIDELIA_KEY"

Chaque ligne du ticket (stamp, earn, spend, redeem, undo …) avec le numéro de carte, les montants, le nom de la caisse et si elle a été annulée. Utile pour les rapprochements et le support.