Overzicht
Digitale kortingsbonnen en vouchers in een wallet staan direct naast betaalkaarten op het toegangsscherm van de smartphone van een klant, wat zorgt voor aanzienlijk hogere inwisselpercentages dan kortingscodes per e-mail of papieren bonnen. Passinstance biedt cryptografische bescherming, fraudebestendige eenmalige verificatie en directe ongeldigmaking van de pas bij inwisseling aan de kassa.
Backendarchitectuur & pastypetoewijzing
In de Passinstance-backend worden kortingsbonprogramma's gekoppeld aan de officiële kortingsbonprimitieven van Apple Wallet en Google Wallet:
-
Pastype (pass type):
coupon(gebruikt de native Apple-kortingsbonlay-out met een opvallend visueel kortingslabel). -
Demoblauwdruk in catalogus:
promotional-coupon(beschikbaar tijdens onboarding). -
Standaard validatiemodus:
VOIDED_AFTER_SCAN scan mode. -
Belangrijkste domeinbeperkingen:
- limitToOneActivePerPass: true: Beperkt slimme downloadlinks tot één apparaat, zodat kortingslinks niet in groepen kunnen worden gedeeld. - expirationDate: W3C ISO 8601-tijdstempel dat automatisch native vervalmeldingen op het toegangsscherm activeert. - addSecurityAnimation: true: Toont een dynamische holografische rand rond 2D-barcodes om fraude met statische screenshots te voorkomen.
Inwisseling & fraudebestrijding tijdens uitvoering
De inwisselingsworkflow aan de kassa dwingt strikte eenmalige geldigheid af via atomaire databasetransacties in Pass Mechanics Engine:
Voorkomen van screenshot- en herhalingsfraude
Wanneer een kassamedewerker de barcode van de kortingsbon scant:
-
1
De scanner stuurt een verzoek naar
POST /api/v1/scansmetscannedBarcodeValueen de geheimex-scanner-keyvan de scanner. -
2
De server bevestigt dat de passtatus
ACTIVEis en dat het huidige tijdstip vóórexpirationDateligt. -
3
Indien geldig, zet de database de passtatus atomair om naar
VOIDED, kentvoidReason: "SCANNED_AT_CHECKOUT"toe en legt de scantransactie vast. -
4
Als een medewerker of kwaadwillende dezelfde barcode nogmaals scant, weigert de validatie-engine de transactie direct met beslissingscode
ALREADY_VOIDEDen foutmeldingPASS_VOIDED_AFTER_SCAN. -
5
Tegelijkertijd plaatst Passinstance een achtergrondpushmelding voor Apple APNs en Google Wallet in de wachtrij. De pas op de telefoon van de klant wordt onmiddellijk grijs met een duidelijk watermerk "Ingewisseld" ("Redeemed"), waardoor hergebruik aan een andere kassa wordt geblokkeerd.
Concrete scanverzoek- & respons-DTO's
Kassasystemen, scannerterminals en e-commerce check-outs communiceren met het validatie-endpoint:
HTTP-verzoek
/api/v1/scans
{
"scannedBarcodeValue": "PI-CPN-849201",
"operatorId": "emp_sarah_m"
}
HTTP-respons (200 OK)
{
"decision": "SUCCESS",
"status": "ACCEPTED",
"passSnapshot": {
"id": "pass_cpn_849201",
"templateId": "tmpl_coupon_7712",
"serialNumber": "PI-CPN-849201",
"status": "VOIDED",
"attributes": {
"discount": "25% OFF",
"terms": "Valid on purchases over €50"
}
}
}
Beveiligingsmaatregelen voor campagnedistributie
Bij het verspreiden van kortingsbonnen via openbare PassFlow-pagina's, API-aanmaak of sms-campagnes:
-
Downloadvervaldatum (
enableDownloadUntil): Stel een strikte datum-tijd in ("YYYY-MM-DD HH:mm"of ISO-tijdstempel inrequest payload/ sjabloonconfiguratie) waarna niet-geclaimde downloadlinks HTTP 410 Gone retourneren. -
Toegangs-PIN-beveiliging: Beveilig waardevolle promotielinks met een toegangs-PIN (
?pin=ofX-Wallet-Experience-Pin) die per sms of aankoopbon wordt meegestuurd. -
CRM- & e-commercecorrelatie (
externalId): Geef eenexternalId(bijv.order_88412_cpn) mee opPOST /api/v1/passesof/api/v1/passes/upsert-by-external-idzodat inwisselingen van eenmalige vouchers netjes kunnen worden verwerkt in uw ordersysteem. -
Koppeling aan één apparaat: Schakel
limitToOneActivePerPassin zodat de geserialiseerde downloadlink van elke klant zich vergrendelt aan het eerst geregistreerde apparaat in plaats van vrij rond te gaan in openbare groepen.
Belangrijk:
VOIDED_AFTER_SCAN scan modemaakt de pas onmiddellijk ongeldig (VOIDED) na een geldige scan, terwijlINVALIDATE_AFTER_SCAN scan modede status opINACTIVE/REDEEMEDzet. Controleer altijd welkeScanModeaansluit bij uw boekhoudkundige en wallet-weergavevereisten.
Lees meer in ons Overzicht van kortingsbonnen & vouchers.
