Carte à tampons
Configurer un modèle de Carte à tampons pour Apple Wallet et Google Wallet : objectif de tampons, comportement lorsqu’elle est pleine, une image par nombre de tampons et un avantage de récompense.
Une carte de tampons est la version numérique de la carte de fidélité papier tamponnée à chaque visite : « achetez neuf cafés, le dixième est offert ». La Carte montre combien de tampons ont été collectés, l’image sur la carte change à chaque tampon, et lorsque l’objectif est atteint The Wallet Crew peut accorder automatiquement une récompense.
Une carte de tampons est son propre type de modèle de Carte dans The Wallet Crew. Elle ressemble et fonctionne comme une carte de fidélité dans Apple Wallet et Google Wallet. Comme le compteur vit sur la Carte elle-même, une carte de tampons fonctionne sans aucun système de fidélité externe.
Comment fonctionne une carte de tampons
Chaque Carte de tampons comporte un tableau de tampons : le compteur, l’objectif et la liste de chaque tampon ajouté ou corrigé. L’ajout d’un tampon pousse la mise à jour vers le Wallet du détenteur.
Dans Apple Wallet
Dans Apple Wallet, une carte de tampons utilise la mise en page de carte de magasin, comme une carte de fidélité. Le bande l’image derrière le champ principal est remplacée par l’image du nombre de tampons actuel, afin que le détenteur voie les tampons se remplir.
Quand Utiliser la nouvelle mise en page de poster est activé dans l’onglet Apple, les iPhone exécutant iOS 27 ou version ultérieure affichent la carte avec la mise en page de poster, et le visuel du poster du nombre actuel est utilisé à la place de la bande. Les iPhone plus anciens conservent la mise en page classique avec la bande, d’où le besoin de conserver les images de bande. Voir Style et mise en page de la Carte pour la mise en page de poster et les autres champs Apple Wallet, et le guide de la carte de fidélité pour des conseils sur l’image de poster.
Dans Google Wallet
Dans Google Wallet, une carte de tampons est une Carte de fidélité. Le visuel principal est remplacée par l’image du nombre de tampons actuel. Le nombre n’est pas écrit automatiquement dans le champ de points de Google : pour l’afficher en texte, référencez les variables de tampons dans un champ (voir Afficher le nombre dans les champs de la Carte).
Créer un modèle de carte de tampons
Un modèle de carte de tampons se crée comme n’importe quel autre modèle de Carte, puis se complète avec ses paramètres de tampons et ses images. Pour accorder une récompense lorsque la carte est pleine, créez d’abord le modèle d’avantage de récompense de la récompense.
Créer le modèle
Ouvrir Wallet → Modèles, cliquez sur Ajouter, puis choisissez Carte à tampons. Des modèles de départ de carte de tampons prêts à l’emploi sont disponibles pour une boulangerie, un café, une pizzeria, un lavage de voiture, le toilettage pour animaux, un bar à jus, un salon de coiffure et une salle de sport. Ils incluent un compteur de tampons, un comportement d’objectif et des visuels pour chaque nombre de tampons, et constituent une bonne base à adapter.
Ajouter une image par nombre de tampons
Dans l’onglet Apple onglet, ouvrez Images → Images de tampons et ajoutez une image de bande pour chaque nombre, ainsi qu’un visuel de poster pour chaque nombre lorsque la mise en page de poster est activée. Dans l’ Google onglet, ajoutez une image principale pour chaque nombre.
Pour transformer une carte de fidélité existante en carte de tampons, créez un nouveau modèle de carte de tampons et déplacez-y les cartes, par exemple à l’aide d’une automatisation en utilisant Changer le modèle de Carte.
Paramètres de tampons
Le Tampons carte dans l’ Général onglet définit combien de tampons atteignent l’objectif, et ce que la Carte fait lorsqu’elle y arrive.

Tampons pour atteindre l’objectif
Obligatoire. Entre 1 et 100.
Lorsque l’objectif est atteint
Ce que fait la carte une fois pleine. Voir les options ci-dessous.
Modèle d’avantage de récompense
Facultatif. Un modèle d’avantage de récompense accordé une fois l’objectif atteint, par exemple « Boisson gratuite au choix ». Choisissez Aucune récompense pour gérer la récompense ailleurs.
Rester pleine, effacer au prochain tampon (par défaut)
Le tableau complet reste visible. Le tampon suivant efface le tableau et compte comme le premier tampon d’un nouveau cycle.
La plupart des programmes : le détenteur profite d’une carte pleine jusqu’à la prochaine visite.
Effacer immédiatement
Le tableau s’efface dès que l’objectif est atteint, donc un tableau plein n’est jamais affiché.
Programmes où la récompense est le seul signal dont le détenteur a besoin.
Rester pleine
La carte refuse les tampons supplémentaires une fois pleine.
Collections ponctuelles, comme une saison de matchs, où une nouvelle carte est émise pour le cycle suivant.
L’avantage de récompense est accordé une fois par cycle. Lorsque l’objectif est de nouveau atteint alors que la récompense précédente figure encore sur la Carte, la récompense existante est actualisée plutôt que dupliquée, de sorte qu’un détenteur ne porte qu’une seule récompense active à la fois.
Images de tampons
Les images de tampons rendent la progression visible : il y a une image pour chaque nombre que la carte peut afficher, de Vide (0 tampons) jusqu’à l’objectif. Une carte avec un objectif de 10 nécessite donc 11 images par emplacement d’image. Avec Effacer immédiatement, la carte pleine n’est jamais affichée, donc l’image du nombre objectif n’est pas nécessaire.

Bande Apple
Onglet Apple → Images → Images de tampons
1200 × 462 px
Pour chaque nombre.
Poster Apple
Onglet Apple → Images → Images de tampons
1236 × 1680 px
Pour chaque nombre, lorsque Utiliser la nouvelle mise en page de poster est activé.
Image principale Google
Onglet Google → Images de tampons
1032 × 336 px
Pour chaque nombre.
Les applications Wallet recadrent les images qui ne correspondent pas à ces proportions, donc gardez les tampons à l’écart des bords. Modifier l’objectif ajoute ou supprime des lignes dans l’éditeur ; les lignes remplies conservent leurs images.
Afficher le nombre dans les champs de la Carte
Le tableau de tampons est accessible à tous les champs du modèle via Liquid, ce qui est utile pour un texte comme « 7 / 10 tampons » ou « 3 de plus pour une boisson gratuite ».
{{ stamps.count }}
Tampons collectés. 0 sur une carte jamais tamponnée.
{{ stamps.target }}
Tampons nécessaires pour atteindre l’objectif.
{{ stamps.remaining }}
Tampons encore nécessaires, jamais en dessous de 0.
Par exemple, un champ secondaire avec la valeur {{ stamps.remaining }} de plus pour une boisson gratuite tient le détenteur informé sur les deux Wallet. Voir Mise en forme Liquid pour la syntaxe.
Ajouter des tampons
Les tampons sont ajoutés au comptoir avec Carte Scanner, ou par un système tel qu’un POS ou une plateforme e-commerce via l’API. Chaque mouvement est enregistré avec sa date, sa valeur, la personne qui l’a appliqué et une remarque facultative.
Depuis la console d’administration
La page de la Carte affiche le nombre d’une carte de tampons à côté de son type, par exemple 7 / 10 tampons, et l’aperçu dessine le tableau tel que le voit le détenteur.

Le Tampons onglet de la Carte contient le Tableau de tampons: le nombre par rapport à l’objectif, l’état de la carte (Collecte ou objectif atteint), ce qui se passe après l’objectif, et la récompense. En dessous, une grille liste chaque mouvement avec sa Date, la Tampons ajouté ou retiré, la personne qui l’a appliqué (Appliqué par) et les Remarques.

Appliquer des tampons enregistre un mouvement manuellement, par exemple pour un achat effectué sans la carte ou pour corriger une erreur.

Avec Carte Scanner
Le personnel peut tamponner une carte lorsque le profil Carte Scanner exécuté sur l’appareil a Le personnel peut ajouter des tampons activé. Chaque appui sur Ajouter un tampon applique un tampon. Voir Cartes de tampons dans Carte Scanner.
Avec l’API
Les intégrations ajoutent des tampons avec l’endpoint de carte de tampons de la Carte.
Lire le tableau de tampons
GET /api/{tenantId}/passes/{passId}/stamps
Ajouter ou corriger des tampons
POST /api/{tenantId}/cartes/{passId}/tampons
Le corps de la requête contient :
valeur
Obligatoire. Tampons à ajouter (positifs) ou à supprimer en correction (négatifs), entre -100 et 100, jamais 0.
ancienneValeur
Obligatoire. Le compteur lu en dernier par l'appelant. Si le tableau a changé entre-temps, la requête est refusée et rien n'est appliqué, donc une requête rejouée ne peut jamais tamponner deux fois.
remarques
Facultatif. Un commentaire libre, jusqu'à 500 caractères, par exemple le numéro du reçu.
La réponse renvoie le nouveau compteur, l'objectif, l'état de la carte (collecting ou goalReached) et indique si ce mouvement a atteint l'objectif.
La requête est refusée, et rien n'est appliqué, dans les cas suivants :
Le nombre de tampons a changé (409)
ancienneValeur ne correspond plus au compteur.
Relisez le tableau, puis réessayez avec le compteur actuel.
Cible de tampons dépassée (400)
Les tampons envoyés ne tiennent pas dans l'espace restant avant l'objectif.
Envoyez au plus le nombre de tampons restants.
Nombre de tampons inférieur à zéro (400)
Une correction ferait passer le compteur sous zéro.
Corrigez d'au plus le compteur actuel.
Objectif de tampons atteint (400)
La carte est pleine et définie sur Rester pleine.
Émettez une nouvelle carte pour le tour suivant.
Pas une carte à tampons (404)
La Carte n'utilise pas de modèle de carte à tampons.
Vérifiez le modèle de la Carte.
Voir la référence de l'API de carte à tampons pour les autorisations et les charges utiles complètes.
Suivre les cartes à tampons
Chaque mouvement de tampon produit des événements qui peuvent être interrogés avec l' API Insights ou envoyés à d'autres outils avec webhooks.
Carte:StampApplied
Un tampon, ou une correction, est enregistré.
Carte:GoalReached
Un mouvement atteint l'objectif, une fois par tour.
Carte:StampsReset
Le tableau est effacé après l'objectif, avec Rester pleine, effacer au prochain tampon ou Effacer immédiatement.
Les événements contiennent le compteur, l'objectif, le comportement et, pour l'objectif, le modèle d'avantage de récompense, ce qui permet de mesurer facilement combien de détenteurs terminent une carte et combien de temps cela prend.
Erreurs de configuration courantes
Le modèle est vérifié à l'enregistrement et par le test de configuration du locataire. Les messages les plus courants sont :
Une Carte à tampons doit déclarer sa configuration « stamps ».
Renseignez la Tampons carte dans l'onglet Général.
La cible de tampons doit être au moins 1, mais vaut N.
Définissez Tampons pour atteindre l’objectif entre 1 et 100.
L'image de tampon Apple pour le compteur N n'a pas son image de bande.
Ajoutez la bande Apple pour ce compteur.
L'image de tampon Apple pour le compteur N n'a pas son visuel d'affiche.
Ajoutez le visuel d'affiche pour ce compteur, ou désactivez Utiliser la nouvelle mise en page de poster.
L'image de tampon Google pour le compteur N n'a pas son image hero.
Ajoutez le hero Google pour ce compteur.
L'image de tampon Apple (ou Google) déclare le compteur N, que la carte n'affiche jamais.
Supprimez l'image supplémentaire, souvent laissée après avoir abaissé l'objectif ou choisi Effacer immédiatement.

