Wallet pass maken: zo zet je een digitale pas op in Apple Wallet

Wallet pass maken: zo zet je een digitale pas op in Apple Wallet

Je maakt een wallet pass op twee manieren: als consument gebruik je iOS 27 met de foto of screenshot route, of je kiest handmatig een sjabloon in Wallet. Als ontwikkelaar bouw je een gesigneerde .pkpass via PassKit, met een webservice voor latere updates. Voor ondernemers die snel een stempelkaart willen lanceren zonder zelf te programmeren, biedt een kant en klaar platform zoals Beepify een directe route naar Apple Wallet en Google Wallet.

Kort samengevat:

• De automatische fotodetectie vereist een iPhone 15 Pro of nieuwer met Apple Intelligence; op oudere modellen werkt de handmatige sjabloonroute.
• Ontwikkelaars hebben een Apple Developer account, Pass Type ID en geldig certificaat nodig; voor updates zijn ook een webservice en betrouwbare apparaatregistratie vereist.
• Apple Wallet ondersteunt QR, Aztec en PDF417, maar het juiste formaat hangt af van de scanner; test daarom op de kassa en bij wisselende helderheid.
• Voor marketingmeldingen is aparte, aantoonbare toestemming nodig die klanten net zo eenvoudig kunnen intrekken als zij die geven; houd die los van stempelupdates.
• Bij pasupdates stuurt je server alleen een lichte APNs melding; het apparaat haalt daarna zelf de gewijzigde pas op, dus registratie moet betrouwbaar blijven.

Inhoudsopgave

• Wat je nodig hebt voordat je begint
• Pas maken in Wallet via iOS 27: foto of handmatig
• PassKit workflow: .pkpass maken en passen updaten
• Pas verspreiden: via app, web, e-mail of Add to Wallet badge
• Barcodes, NFC en scannertests voor betrouwbare acceptatie
• Privacy en AVG: toestemming bij marketing via je pas
• Perspectief: waarom een geïntegreerde Wallet oplossing vaak sneller werkt
• Beepify: een Apple Wallet stempelkaart lanceren zonder eigen ontwikkeltraject
• Veelgestelde vragen
• Bronnen

Wat je nodig hebt voordat je begint

Voordat je aan de slag gaat, bepaalt je rol welke voorbereiding nodig is. Een consument die een bestaande pas wil toevoegen heeft weinig nodig, maar een ontwikkelaar die zelf passen wil uitgeven, moet eerst een aantal zaken regelen.

Voor de automatische foto route in iOS 27 is Apple Intelligence vereist, wat alleen werkt op een iPhone 15 Pro of nieuwer met de functie ingeschakeld, zo blijkt uit berichtgeving over iOS 27. Wie een oudere iPhone heeft, gebruikt de handmatige sjabloonroute in Wallet, die op vrijwel elk model werkt.

Voor ontwikkelaars ligt de lat hoger:

• Een Apple Developer account met een geregistreerde Pass Type ID.
• Een door Apple uitgegeven signing certificate om je pas te ondertekenen.
• Een HTTPS webserver die device registraties kan opslaan en APNs credentials beheert.
• Basisbestanden: afbeeldingen in de juiste resoluties, een JSON bestand met pasvelden en een gekozen barcodeformaat.

Bedrijven die passen inzetten voor marketing doen er goed aan om vooraf te bepalen op welke verwerkingsgrondslag ze draaien: de basisdienst (de stempelkaart zelf) steunt meestal op de uitvoering van een overeenkomst, terwijl marketingberichten via de pas vaak aparte toestemming vereisen.

Pro-tip: Test je Apple Developer certificaat en Pass Type ID altijd eerst in een testomgeving voordat je naar productie gaat, zodat signing fouten je lancering niet vertragen.

Pas maken in Wallet via iOS 27: foto of handmatig

Sinds iOS 27 heeft Apple het aanmaken van een pas sterk vereenvoudigd. Er zijn twee routes, en welke je kiest hangt af van wat je al in handen hebt: een fysieke kaart om te fotograferen, of enkel de wens om een pas vanaf nul samen te stellen.

Route 1: foto of screenshot

1. Maak een foto van je fysieke kaart of neem een screenshot van een digitale bon met barcode.
2. Open de foto in de Foto’s app, veeg omhoog of tik op Info om de gedetecteerde barcode te zien.
3. Kies Voeg pas toe aan Wallet wanneer Wallet de code herkent.
4. Controleer en bewerk de velden die Wallet automatisch invult, zoals naam en vervaldatum.

Route 2: handmatig een sjabloon kiezen

1. Open Wallet en tik op Voeg kaart toe.
2. Kies Maak een pas aan.
3. Selecteer een sjabloon: lidmaatschap, loyaliteit, evenement of generiek.
4. Vul de velden in en bevestig om de pas toe te voegen.

De keuze van sjabloon bepaalt welke velden beschikbaar zijn. Een loyaliteitssjabloon toont bijvoorbeeld stempels of punten, terwijl een evenementpas plaats en tijd vooraan zet. Volgens de instructies van Apple Support werkt de automatische detectie het best bij scherpe, vlak gefotografeerde barcodes met voldoende contrast tussen code en achtergrond.

De automatische methode vereist specifieke hardware: volgens Tom’s Guide werkt de foto gebaseerde route alleen op een iPhone 15 Pro of nieuwer met Apple Intelligence ingeschakeld, wat betekent dat een deel van de gebruikers op de handmatige route is aangewezen.

Wanneer automatische detectie faalt, bijvoorbeeld door een beschadigde barcode of te weinig licht, is de handmatige sjabloonroute de betrouwbare vangnet. Je verliest dan wel de automatisch ingevulde velden, maar je houdt volledige controle over wat er op de pas komt te staan.

PassKit workflow: .pkpass maken en passen updaten

Voor ontwikkelaars is een wallet pass in de kern een .pkpass bestand: een ondertekende zip met een manifest, een JSON bestand en de bijbehorende afbeeldingen. Volgens de PassKit documentatie van Apple bepaalt het gekozen pastype, zoals boarding pass, coupon, event ticket, store card of generic pass, welke velden en relevantieregels beschikbaar zijn.

De opbouw van een pas

Elke pas heeft een unieke serialNumber en een passTypeIdentifier die hoort bij je Apple Developer account. Het manifest bevat een hash van elk bestand in de pas, zodat Wallet kan controleren of er niets is aangepast na ondertekening.

• Het JSON bestand (pass.json) definieert velden zoals voorzijde, achterzijde, barcode en kleuren.
• Afbeeldingen zoals icon, logo en strip worden in meerdere resoluties meegeleverd.
• Het manifest.json bevat SHA hashes van alle bestanden, vereist voor de ondertekening.

Ondertekenen is verplicht

Een pas moet ondertekend worden met een door Apple uitgegeven certificaat, zoals beschreven in de PassKit documentatie. Zonder geldige handtekening weigert Wallet de pas te accepteren. Dit certificaat en de bijbehorende private key worden ook gebruikt voor pushmeldingen, dus veilige opslag, bijvoorbeeld in een hardware security module of een cloud key management systeem, hoort standaard in je deploy proces.

Updates via webservice en APNs

Een pas die moet kunnen veranderen, denk aan een stempelkaart waarop het aantal stempels oploopt, heeft een webServiceURL en authenticationToken nodig. Zodra een gebruiker de pas toevoegt, registreert het apparaat zich bij je server met een device library identifier en een push token, zo blijkt uit de Apple documentatie over het updaten van passen.

De updateflow werkt als volgt:

• Je server bewaart devices, passes en registrations in aparte tabellen.
• Bij een wijziging stuurt je server een lichte APNs push naar het geregistreerde apparaat.
• Het apparaat vraagt vervolgens zelf de lijst met serialNumbers op en haalt de bijgewerkte pas op.
• Een lastUpdated tag in je passes tabel beperkt onnodige dataoverdracht bij elke fetch.

De push zelf bevat nauwelijks data; hij dient enkel als trigger waarna het apparaat de inhoud ophaalt. Dat ontwerp houdt je server licht, maar vereist wel dat je registratie en autorisatie betrouwbaar afhandelt, anders raken apparaten hun updates kwijt.

Entitlements en testen

In Xcode heb je zelden extra entitlements nodig voor een standaard PassKit integratie, tenzij je functies zoals NFC gebruikt. Test altijd op een fysiek apparaat, nooit alleen in de simulator, en bouw logging in rond signing fouten en registratie responses zodat je snel ziet waar een update vastloopt.

Pro-tip: Bewaar certificaat en private key gescheiden van je broncode, en roteer ze volgens een vast schema om te voorkomen dat een verlopen certificaat je hele updateflow stillegt.

Pas verspreiden: via app, web, e-mail of Add to Wallet badge

Zodra je pas klaar is, bepaal je hoe gebruikers hem ontvangen. Elke route heeft eigen technische aandachtspunten en een ander gebruiksgemak.

• Via een eigen app: je serveert het .pkpass bestand direct vanuit je native app, met het juiste content type (application/vnd.apple.pkpass), wat de vlotste ervaring geeft voor gebruikers die de app al hebben.
• Via een webpagina met Add to Wallet badge: je plaatst de officiële badge op een pagina die linkt naar het .pkpass bestand, zodat bezoekers met één tik de pas toevoegen zonder app te hoeven installeren.
• Via e-mail of een gedeelde link: je stuurt het bestand als bijlage of linkt naar een downloadpagina, wat vooral handig is voor eenmalige tickets of acties.

Bij elke methode moet de server de juiste headers meesturen, anders herkent het besturingssysteem het bestand niet als een wallet pass. Zorg ook voor duidelijke foutafhandeling: als een gebruiker een pas probeert toe te voegen die al in zijn Wallet staat, moet de interface dat helder communiceren in plaats van een onduidelijke foutmelding te tonen.

De webroute met een Add to Wallet badge werkt doorgaans het laagdrempeligst voor nieuwe klanten, omdat er geen app installatie nodig is. Voor bestaande klanten binnen een eigen app ligt de ervaring vaak soepeler, omdat de pas direct vanuit een bekende omgeving wordt toegevoegd.

Barcodes, NFC en scannertests voor betrouwbare acceptatie

Een pas die niet scant, is in de praktijk waardeloos, dus testen op echte hardware is geen overbodige luxe. Wallet ondersteunt QR, Aztec en PDF417 als 2D barcodeformaten, en Apple optimaliseert automatisch de schermweergave bij scannen door onder meer de helderheid te verhogen en de schermoriëntatie vast te zetten, zo meldt de PassKit documentatie.

NFC is een alternatief voor barcodes, maar vereist specifieke hardware aan de kassa en een zorgvuldigere implementatie, wat het voor veel kleinere ondernemingen minder praktisch maakt dan een eenvoudige barcode.

Voor een betrouwbare uitrol doorloop je best deze stappen:

1. Test de barcode op meerdere schermhelderheden, inclusief een scherm met verminderde helderheid door batterijbesparing.
2. Controleer of je gekozen formaat compatibel is met het scannertype op locatie, optische scanners lezen een telefoonscherm anders dan laserscanners.
3. Test verschillende oriëntaties van het scherm om te zien of de pas zich correct aanpast.
4. Voer een veldtest uit op de daadwerkelijke kassa of scanner die je locatie gebruikt, niet enkel in een testomgeving.

Deze stappen voorkom je het meest voorkomende probleem bij wallet passen in de praktijk: een pas die er goed uitziet op het scherm van de ontwikkelaar, maar niet scant op de kassa van de klant.

Privacy en AVG: toestemming bij marketing via je pas

Een wallet pass verzamelt al snel gegevens, zeker zodra je pushmeldingen of locatietriggers inzet. Daarom is het zinvol om onderscheid te maken tussen twee soorten verwerking. De basisdienst, zoals het bijhouden van stempels, steunt doorgaans op de uitvoering van de overeenkomst met de klant. Marketingberichten via de pas, zoals aanbiedingen of herinneringen om terug te komen, vallen vaak onder een ander regime.

Toestemming voor direct marketing moet expliciet, aantoonbaar en eenvoudig intrekbaar zijn, zo stelt de Autoriteit Persoonsgegevens. Dat betekent concreet dat je:

• Een aparte, granulaire toestemming vraagt voor marketingberichten, los van de basisfunctie van de pas.
• Gebruikers duidelijk en begrijpelijk informeert over wat je verstuurt en hoe vaak.
• Intrekking van toestemming net zo eenvoudig maakt als het geven ervan, bijvoorbeeld via een link in elk bericht.
• Gegevens niet langer bewaart dan nodig voor het doel waarvoor je ze verzamelde.

Technisch betekent dit dat je toestemmingsstatus moet vastleggen per gebruiker, los van de registratie voor pas updates. Een pushmelding die puur een stempel update, valt anders te beoordelen dan een pushmelding met een promotionele boodschap, dus houd die twee gescheiden in je serverlogica.

Perspectief: waarom een geïntegreerde Wallet oplossing vaak sneller werkt

Zelf een PassKit integratie bouwen, met certificaatbeheer, een webservice en een registratiedatabase, vraagt tijd die veel salons, cafés en winkels liever in hun klanten steken. Daar zit de kern van een terechte afweging: bouw je dit zelf, of kies je voor een bestaand platform dat deze laag al heeft opgelost.

Wij zien dat ondernemers die zelf beginnen, vaak vastlopen bij certificaatbeheer of de updateflow via APNs, niet bij het ontwerp van de pas zelf. Een kant en klaar systeem neemt die technische laag weg en koppelt rechtstreeks aan Apple Wallet en Google Wallet, zonder dat een klant een aparte app hoeft te installeren. Dat verschuift de aandacht van infrastructuur naar wat een stempelkaart daadwerkelijk succesvol maakt: een duidelijke beloning en een reden om terug te komen.

— erenmette

Beepify: een Apple Wallet stempelkaart lanceren zonder eigen ontwikkeltraject

Een kant en klare stempelkaart opzetten kost geen weken programmeren, maar een paar instellingen. Het systeem koppelt de kaart rechtstreeks aan Apple Wallet en Google Wallet, verzorgt QR gebaseerde stempeluitgifte via scannen en stuurt pushmeldingen naar klanten die al een tijdje niet langs zijn geweest.

Onze aanpak is ontworpen voor salons, cafés en winkels die snel willen starten:

• De kaart kan in eigen huisstijl worden vormgegeven, zonder dat klanten een aparte app downloaden.
• QR scanning geeft direct een stempel bij elk bezoek, zichtbaar in de pas zelf.
• Automatische reviewverzoeken na een bezoek kunnen helpen de online reputatie te versterken.

Benieuwd welk kaarttype bij je bedrijf past? Bekijk de verschillende kaarttypes of ontdek meteen welk abonnement bij je schaal past via onze pricing pagina, waar de Starter start vanaf € 45,00 per maand.

Veelgestelde vragen

Wat heb ik minimaal nodig om een pas te maken in Wallet?

Als consument heb je enkel een recente iPhone nodig: de automatische foto route vereist een geschikte iPhone met Apple Intelligence, terwijl de handmatige sjabloonroute op vrijwel elk model werkt. Ontwikkelaars hebben daarnaast een Apple Developer account, een Pass Type ID en een geldig signing certificaat nodig, zoals beschreven in de PassKit documentatie.

Hoe update ik een wallet pass nadat die al is toegevoegd?

Updates lopen via een webservice die apparaten registreert en vervolgens een lichte pushmelding via APNs stuurt zodra er een wijziging is. Het apparaat haalt daarna zelf de bijgewerkte pas op bij je server, zoals toegelicht in de Apple documentatie over het updaten van passen.

Welke barcodeformaten werken in Apple Wallet?

Apple Wallet ondersteunt QR, Aztec en PDF417 als barcodeformaten, en optimaliseert automatisch de schermweergave om scannen te vergemakkelijken, aldus de PassKit documentatie. Welk formaat het best werkt, hangt af van het scannertype op je locatie, dus testen op echte hardware blijft aan te raden.

Mag ik zomaar pushmeldingen met aanbiedingen sturen via een wallet pass?

Nee, voor marketingberichten is doorgaans aparte, aantoonbare toestemming nodig die net zo makkelijk in te trekken is als te geven, volgens de Autoriteit Persoonsgegevens. Berichten die enkel de basisdienst ondersteunen, zoals een stempel update, vallen hier doorgaans niet onder.

Wat is het verschil tussen een pas maken voor Apple Wallet en Google Wallet?

Apple Wallet werkt met een .pkpass bestand dat lokaal wordt ondertekend met een Apple certificaat, terwijl Google Wallet werkt met een Passes Class en Passes Object die je als issuer aanmaakt via de Business Console of een REST API, zo blijkt uit de Google Wallet documentatie. Beide platforms ondersteunen vergelijkbare functies zoals barcodes en updates, maar de technische implementatie verschilt volledig.

Bronnen

• Apple Developer — Get started with Apple Wallet
• Apple Support — Maak een pas aan in Wallet
• Tom’s Guide — article on iOS 27 Create a Pass
• Autoriteit Persoonsgegevens — Digital direct marketing
• Google Developers — Create Passes Classes and Passes Objects

Aanbevelingen

• Apple Wallet Stempelkaart: Direct in de Wallet van je Klant
• Apple Wallet kaart voor jouw zaak: zo activeer je klanten
• Apple Wallet Stempelkaart: De Complete Gids
• Apple Wallet voor salons: de complete gids