Skip to content
Helpcentrum-gidsOnboardingfase 2
3 min leestijdGecontroleerd 2026-11-16

Klanten- & stempelkaarten

Bouw digitale spaarkaarten met stempelrooster, automatische punten per bezoek en beloningsacties.

In deze gids

Interactieve UI-weergaven

Openen in onboardinggids (6 fasen)

Bekijk de exacte dashboardpanelen, knoppen en ingezoomde toelichtingen bij deze gids.

Ingezoomde UI-focus
Belangrijke UI-onderdelen

Kiezer 'Add a Pass Mechanic' (Ingesneden)

Kies uit 6 ingebouwde mechanieken: Stempelkaart, Stempelverzilvering, Tegoed (Stored Value), Punten & niveaus, Validatie eenmaal per dag of Vervaldatum verlengen.

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-card en coffee-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.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
STEMPELKAARTCYCLUS & LIMIETAFHANDELING
FASE 01 VOORTGANGSPIPELINE
1
Eerste scan (0 stempels)
2
+1 stempel per bezoek
3
Kaart bereikt maximumValue (bijv. 8)
FASE 02A onCap: "noop"
Kaart stopt op 8/8
Uitgevoerde actie: NOOP
Vraag medewerker om in te wisselen
FASE 02B onCap: "reset"
Beloning toegekend
Stempelteller terug naar 0
Nieuwe cyclus start direct
FASE 02C Standaardvalidatie
Geeft HTTP 400 terug
"Stempelkaart is vol; claim eerst beloning"

Uitvoeringslogica van de stempelengine & limietgedrag

Wanneer een baliemedewerker de pas van de klant scant, evalueert Pass Mechanics Engine de actieve drempels:

  1. 1
    Stempel toevoegen: Telt defaultChangeValue (standaard 1) op bij het huidige passaldo:
TEXT
newStamps = clamp(currentStamps + defaultChangeValue, 0, maximumValue)
  1. 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).

  1. 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.

  1. 4
    CRM-correlatie (externalId): Koppel uw loyaliteitslid-ID aan Pass.externalId, zodat POS, webshop en mobiele app stempelupdates netjes kunnen upserten via POST /api/v1/passes/upsert-by-external-id.
Selectiekaarten voor sjabloonmechanieken
Selectiekaarten voor sjabloonmechanieken

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.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.