Skip to content
Helpcentrum-gids · NFC & contactloosOnboardingfase 2
3 min leestijdGecontroleerd 2026-11-16

NFC-passconfiguratie

Onderscheid open NDEF-NFC-downloadtags (URL openen) van versleutelde NFC-inwisseling op lezers.

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

Barcode-, QR-code- & NFC-instellingen (Ingesneden)

Configureer QR-code-indeling, waardebron, dynamische token-inhoud ({memberQrToken}), terugvaltekst ({passReference}) en NFC.

Twee zeer verschillende toepassingen van "NFC" in Wallet-passen

Belangrijk: Maak voordat u contactloos afrekenen of toegangscontrole met stakeholders afbakent onderscheid tussen NDEF NFC Tag-distributie (open-standaard URL-tags die out-of-the-box op elke smartphone werken) en versleutelde Tap-to-Redeem (Apple VAS en Google Smart Tap, waarbij een versleutelde paspayload vanuit de wallet naar een gespecialiseerde NFC-lezerterminal wordt verzonden).

MogelijkheidDoelProtocol & modelBenodigde hardware & goedkeuring
NDEF NFC Tag-distributieKlant tikt met ontgrendelde telefoon op baliesticker -> opent URL voor Toevoegen aan Wallet of PassFlowISO/IEC 14443 NDEF URI RecordAlleen goedkope NTAG213/215-sticker; geen lezerhardware of Apple VAS nodig.
Tap-to-Redeem (Apple VAS / Google Smart Tap)Klant houdt telefoon/Watch bij terminal -> lezer ontsleutelt paspayload (message)Apple VAS & Google Smart Tap (NFC-model & Template.nfc)Vereist VAS/Smart Tap NFC-lezerhardware + configuratie van publieke/privésleutels van de handelaar (niet standaard op elk account ingeschakeld).

Architectuur van het Pas-NFC-model & het pass.json nfc-woordenboek

Wanneer contactloos inwisselen op een sjabloon is ingeschakeld (Template.nfc / Passinstance database NFC-model), sluit Passinstance cryptografische contactloze metadata in zowel het nfc-woordenboek van Apple Wallet pass.json als in smartTapRedemptionValue van het Google Wallet-object:

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
VERSLEUTELDE NFC-PASPAYLOAD & TERMINAL-HANDSHAKE
FASE 01 SJABLOON- & PAS-NFC-SCHEMA (NFC-model)
nfcEnabled: true
message: Dynamische payload (max. 64 bytes, bijv. serialNumber of token)
encryptionPublicKey: Base64 ECDH P-256 Publieke sleutel (prime256v1)
requiresAuthentication (nfcFaceIdRequired): Face ID / Touch ID afdwingen
nfcNoBarcode: Optioneel verbergen van visuele 2D-barcode op de voorzijde
Apple Wallet pass.json
FASE 02A "nfc": {
"message": "PI-8849-2026-X9", "encryptionPublicKey": "MDkwEw...", "requiresAuthentication": true }
[ 13.56 MHz ISO/I
POS- / TOEGANGSLEZERTERMINAL (
1
Zendt Apple VAS Pass Type ID Hash & G
2
Voert efemere ECDH P-256-sleutelovere
3
Stuurt message door naar `POST/api
Google Wallet WalletObject
FASE 02B "smartTapRedemptionValue": "<msg>"
"hasUsers": true
Gekoppeld aan Class redemptionIssuer (collectorId` / ECDH P-256-sleutel)
14443 RF-veld ]
/ Verifone / Ingenico) le Smart Tap Collector ID uit omst & AES-GCM-ontsleuteling uit
/scansof/api/v1/reader/redeem`

NFC-configuratie-eigenschappen & beperkingen

Eigenschap (NFC / Template.nfc)Apple pass.json-sleutelType & beperkingTechnisch gedrag
messagenfc.messagestring (Max. 64 bytes UTF-8)De leesbare payload die door het apparaat wordt versleuteld en verzonden naar de NFC-lezer (standaard de serialNumber of externalId van de pas).
encryptionPublicKeynfc.encryptionPublicKeystring (Base64 DER/PEM)Gecomprimeerde of ongecomprimeerde ECDH P-256 (prime256v1) publieke sleutel die overeenkomt met de privésleutel die op uw NFC-lezerterminals is geladen.
nfcFaceIdRequirednfc.requiresAuthenticationbooleanIndien true, vereist iOS dat de pashouder zich authenticeert via Face ID, Touch ID of toegangscode voordat de VAS-payload wordt verzonden.
nfcNoBarcodeLaat barcodes[] wegbooleanIndien true, wordt de visuele 2D QR-/Aztec-barcode aan de voorzijde van de pas onderdrukt zodat de pas alleen via een versleutelde NFC-tap kan worden aangeboden.

Voorbeeld: Apple Wallet pass.json nfc-woordenboek & sjabloonconfiguratie

Wanneer nfcEnabled: true op een sjabloon is geconfigureerd, serialiseert Passinstance het nfc-woordenboek aan de root van pass.json:

JSON
{
  "formatVersion": 1,
  "passTypeIdentifier": "pass.com.phenixroasters.access",
  "serialNumber": "PI-8849-2026-X9",
  "nfc": {
    "message": "PI-8849-2026-X9",
    "encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
    "requiresAuthentication": true
  }
}

Om de NFC-instellingen van een sjabloon via de REST API bij te werken, patcht u de sjabloonresource (en verifieert u de configuratie met POST /api/v1/nfc/test):

JSON
PATCH /api/v1/templates/7b9e4c12-3f81-4a90-b8d2-19c48a70e112
{
  "nfc": {
    "message": "{serialNumber}",
    "encryptionPublicKey": "MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE8v3x9K2m5N7p1Q4r6S8t0V2w4Y6z8A1b3C5d7E9f0G2h4J6k8L0m2N4p6Q8r0S==",
    "requiresAuthentication": true
  },
  "nfcFaceIdRequired": true,
  "nfcNoBarcode": false
}

Best practice: houd de optische 2D-barcode als terugvaloptie ingeschakeld

Tenzij u hoogbeveiligde werknemerstoegangspassen uitrolt waarbij screenshots van visuele barcodes strikt moeten worden voorkomen (nfcNoBarcode: true of addSecurityAnimation: true), kunt u nfcNoBarcode: false het best ingeschakeld houden zodat passen een optische 2D QR- of Aztec-barcode tonen als back-up. Zo kunnen medewerkers passen alsnog valideren met optische camera's als een terminal offline is of de NFC-antenne op de telefoon van een klant is uitgeschakeld.

Bekijk Bereik van NFC Wallet-passen, Apple VAS, Google Smart Tap en Compatibele NFC-lezers.

Gerelateerde product- en ontwikkelaarsdocs

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.