Hoe slimme pasinstallatie werkt
Het toevoegen van een klantenkaart, evenementticket, lidmaatschapspas of coupon aan uw smartphone duurt minder dan 10 seconden en vereist geen download van een app van derden. Wanneer u een slimme link van Passinstance opent, detecteert de backend het besturingssysteem van uw apparaat en stuurt u door naar ofwel een Apple Wallet .pkpass-bundel (ondertekend met de Pass Type ID bundleId van de handelaar) ofwel een met RS256 ondertekende Google Wallet Save JWT.
Eindpunten voor slimme distributie
Passinstance faciliteert installatiestromen voor pashouders via drie openbare routepatronen die worden beheerd door Download Page API en Public Download Page:
| Routepatroon | Methode | Doel |
|---|---|---|
/d/:slug | GET | Korte vanity-link voor sms, QR-posters en e-mailcampagnes. Voert automatische OS-detectie en wallet-overdracht uit. |
/download/:slug | GET | Expliciete PassFlow-downloadpagina met pasvoorbeeld, merkthema en platformspecifieke Add to Wallet-knoppen. |
/s/:token | GET | Cryptografisch ondertekende toegangslink per pashouder met optionele vervaldatum (downloadUntil) en pincodecontroles. |
Stapsgewijze handleiding voor pashouders
1. Op iPhone en Apple Watch (Apple Wallet)
-
1
Tik op uw persoonlijke paslink zodat deze wordt geopend in Safari (als u op de link hebt getikt binnen Instagram, TikTok of LinkedIn, tikt u rechtsonder op het browserpictogram om deze in de standaard Safari-browser te openen).
-
2
Tik op Voeg toe aan Apple Wallet (Add to Apple Wallet) — iOS herkent onmiddellijk het
application/vnd.apple.pkpass-pakket en schuift het systeemeigen pasvoorbeeld omhoog. -
3
Tik rechtsboven in het voorbeeldscherm op Voeg toe (Add).
-
4
Synchronisatie met Apple Watch: Als u een gekoppelde Apple Watch draagt, spiegelt iOS geschikte passen automatisch naar de Wallet-app om uw pols.
-
5
Snelle toegang: Druk op elk gewenst moment tweemaal op de zijknop van uw iPhone om uw opgeslagen pas direct te tonen bij de kassa of bij de ingang van een locatie.
2. Op Android (Google Wallet)
-
1
Open uw paslink in Google Chrome of uw standaard Android-browser.
-
2
Tik op Toevoegen aan Google Wallet (Add to Google Wallet) — hiermee opent u het geverifieerde opslagscherm van Google (
https://pay.google.com/gp/v/save/<jwt>). -
3
Controleer of het Google-account dat bovenaan het scherm wordt weergegeven, overeenkomt met het account waarmee u bent ingelogd in de Google Wallet-app op uw telefoon, en tik vervolgens op Toevoegen aan Wallet (Add to Wallet).
-
4
Tik op Bekijken in Wallet (View in Wallet) om uw barcode of contactloze NFC-pas direct weer te geven.
3. Een paslink openen op een laptop of desktopcomputer
Desktopcomputers ondersteunen Apple Wallet of Google Wallet niet standaard. Wanneer u een /d/:slug- of /s/:token-link opent op macOS of Windows:
{
"detectedPlatform": "DESKTOP",
"handoffMode": "QR_CODE_LANDING_PAGE",
"qrTargetUrl": "https://wallet.yourbrand.com/s/eyJhbGciOiJIUzI1Ni...",
"instructions": "Scan deze QR-code met de camera van uw iPhone of Android-toestel om de pas rechtstreeks aan uw telefoon toe te voegen."
}
Richt de camera van uw iPhone of Android-telefoon op de QR-code op het scherm en tik op de melding die verschijnt om de installatie op uw telefoon te voltooien.
Belangrijk: Sommige uitgevers beveiligen waardevolle VIP-kaarten of personeelsbadges met een koppeling aan één apparaat (
limitToOneActivePerPass: true) of een downloadpincode. Voer indien gevraagd de pincode in die naar uw e-mailadres of via sms is verzonden voordat u op Add to Wallet tikt.
Ondervindt u problemen bij het installeren van uw kaart? Bekijk Wallet-problemen oplossen of ontdek hoe u een bestaande kaart terugvindt in Uw pas vinden of herstellen.
