Overzicht
Klanten- & stempelkaarten digitaliseren traditionele papieren stempelkaarten ("8 koppen koffie kopen, de 9e gratis") tot interactieve native wallet-passen op smartphones. Klanten raken hun kaart nooit kwijt, medewerkers zetten in twee seconden een stempel via optische QR-scanning en ondernemers stimuleren herhaalbezoek met geautomatiseerde meldingen op het toegangsscherm.
Backendarchitectuur & mechaniek-enums
Digitale stempelkaarten combineren visuele stripafbeeldingen met deterministische regeluitvoering in Pass Mechanics Engine:
-
Pastype (pass type):
storeCard. -
Catalogus-demoblauwdrukken:
restaurant-stamp-cardencoffee-loyalty. -
Mechaniektypen (mechanic type):
- STAMP_CARD_ADD: Verhoogt het actieve aantal stempels met defaultChangeValue (doorgaans 1). - STAMP_CARD_DEDUCT: Laat kassamedewerkers per ongeluk gezette stempels corrigeren of stempels aftrekken bij gedeeltelijke inwisseling.
-
Configuratie van het visuele stempelraster:
- StampImage-array: Koppelt afzonderlijke visuele assetstatussen voor stempelposities 0..N (weergegeven op Apple stripafbeeldingen en modulaire Google Wallet-afbeeldingen). - maximumValue: Totaal aantal stempels dat nodig is om de kaart te vullen (bijv. 8 of 10). - rewardImageResourceId: Aangepast trofee- of beloningspictogram dat verschijnt zodra de kaart vol is.
Uitvoeringslogica van de stempelengine & limietgedrag
Wanneer een baliemedewerker de pas van de klant scant, evalueert Pass Mechanics Engine de actieve drempels:
-
1
Stempel toevoegen: Telt
defaultChangeValue(standaard1) op bij het huidige passaldo:
newStamps = clamp(currentStamps + defaultChangeValue, 0, maximumValue)
-
2
Limietafhandeling (
onCap) & actiesemantiek (scan action / transaction type):
- onCap: "noop": Wanneer de kaart het maximale aantal stempels bereikt, retourneert de engine { ok: true, reason: "Card is full", appliedAction: "NOOP" }. De pas blijft vol zodat medewerkers de volle kaart kunnen controleren en de beloning kunnen uitreiken. - onCap: "reset": Activeert automatisch de beloningsgebeurtenis en zet de stempels terug op 0: { ok: true, reason: "Card reset" }. - Standaardgedrag: Retourneert { ok: false, reason: "Stamp card is full" }, zodat medewerkers een aparte inwisselingsstroom moeten starten (POST /api/v1/mechanics/redeem of POST /api/v1/passes/:id/use met scan action: INCREMENT, DECREMENT, VALIDATE, vastgelegd met transaction type: EARN, REDEEM, ADJUST, SCAN).
-
3
Gedrag bij het claimen van beloningen (
rewardClaimBehavior):
- RESET_TO_ZERO: Zet alle stempels terug naar 0 zodra medewerkers de beloning inwisselen. - START_NEW_CYCLE: Neemt eventuele overtollige stempels uit aankopen met meerdere artikelen mee naar de volgende spaarcyclus. - KEEP_COMPLETED: Behoudt de volle visuele status totdat de beloningsvoucher wordt geclaimd.
-
4
CRM-correlatie (
externalId): Koppel uw loyaliteitslid-ID aanPass.externalId, zodat POS, webshop en mobiele app stempelupdates netjes kunnen upserten viaPOST /api/v1/passes/upsert-by-external-id.

Waarborgen voor dagelijks scannen (VALID_ONCE_PER_DAY)
Om onbedoeld dubbel stempelen of misbruik aan de kassa te voorkomen, koppelt u de secundaire regel VALID_ONCE_PER_DAY:
-
De engine bepaalt de tijdzone van de vestiging via
resolveCustomerTimeZone. -
Als een medewerker dezelfde klantenkaart tweemaal op dezelfde kalenderdag scant, geeft de tweede scan een informatieve waarschuwing (
ALREADY_SCANNED_TODAY) zonder een ongeautoriseerde tweede stempel toe te voegen.
Realtime updates op het toegangsscherm
Telkens wanneer een stempel wordt toegevoegd of ingewisseld:
-
Stuurt Passinstance een stille APNs-melding naar de iPhone van de klant.
-
Werkt Apple Wallet de visuele stempelstrip bij en toont een melding op het toegangsscherm: "U heeft een stempel verdiend! U heeft nu 5 van de 8 stempels."
-
Werkt Google Wallet de live kaartwidget bij en toont een melding op Android.
Belangrijk: Dynamische stripafbeeldingen voor stempelkaarten worden door de grafische engine van Passinstance automatisch gegenereerd in retina-resoluties (@1x, @2x, @3x), wat zorgt voor haarscherpe stempelvakjes op smartphoneschermen met hoge pixeldichtheid.
Lees ons volledige overzicht over Digitale stempelkaarten, verken Restaurants & cafés of raadpleeg de Gids voor stempelverzamelregels.
