Cartes à tampons, actions et boutique

Trois programmes se configurent dans la section Fidélité du studio, sans écrire d’offre à la main. Le studio génère et publie lui-même l’offre correspondante (étiquetée programme) : le moteur l’applique comme n’importe quelle offre.

Carte à tampons

Chaque passage en caisse d’un client identifié ajoute un ou plusieurs tampons. Quand la carte est pleine, le moteur débloque la récompense (un coupon émis à partir d’un modèle, ou des points) et une nouvelle carte repart de zéro.

Réglage	Rôle
Tampons nécessaires	2 à 50
Tampons par passage	1 à 10
Conditions	montant minimal du ticket, articles ou magasins concernés (facultatif)
Récompense	coupon (modèle de coupon) ou points (compteur et montant)
Design	titre, couleur, couleur d’accent, icône du tampon

Les tampons sont comptés sur un compteur dédié STAMP_<CODE> (type visites). Le studio affiche un aperçu en direct de la carte, vide ou cochée, et la télécharge en SVG ou en PNG (1280 × 800) pour l’application, l’e-mail ou le wallet.

Dans la réponse du moteur, l’action stamp_card indique stampsBefore, stampsAdded, stampsAfter et completed (cartes complétées par ce ticket). En protocole Beone, la progression est rendue en message caisse (7/10).

Récompense pour une action

Une action hors caisse (avis laissé, parrainage, profil complété…) rapporte une récompense. L’application de l’enseigne appelle le moteur :

POST /v1/actions
X-Api-Key: …

{ "action": "AVIS", "reference": "avis-48213", "customer": { "type": "card", "value": "2900000012345" } }

reference rend l’appel idempotent : la même action, pour le même client et la même référence, n’est récompensée qu’une fois. Le programme fixe la récompense et une limite facultative par client et par période (jour, semaine, mois, année ou pour toujours). Le studio permet aussi d’enregistrer une action à la main depuis la fiche client.

Boutique de récompenses

Le client échange ses points contre une récompense du catalogue : le studio (ou la caisse) débite les points et émet le coupon dans la même transaction. Chaque récompense a un coût, un modèle de coupon, et peut avoir un stock, une limite par client et des dates de disponibilité. Un échange peut être annulé tant que le coupon n’a pas été utilisé : le coupon est annulé et les points sont recrédités.