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

Apple VAS

Vereisten voor Apple Value Added Services (VAS): VAS-certificaatrechten, aanvraagproces en compatibele lezers.

In deze gids

Wat is Apple Value Added Services (VAS)?

Apple Value Added Services (VAS) is Apple's contactloze NFC-communicatieprotocol gebaseerd op ISO/IEC 14443 Type A/B (13,56 MHz). Hiermee kan een versleutelde paspayload (nfc.message, max. 64 bytes) die is opgeslagen in Apple Wallet op een iPhone of Apple Watch draadloos worden verzonden wanneer het apparaat bij een door Apple gecertificeerde contactloze lezer wordt gehouden — zonder het scherm te ontgrendelen voor een barcode en zonder per ongeluk een Apple Pay-betaalpas of creditcard te belasten.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
APPLE VAS-RECHT & ECDH P-256-HANDSHAKE
FASE 01 FASE 1: RECHT & SLEUTELINRICHTING (NFC entitlement request)
1
Handelaar vraagt Apple NFC Entitlement aan (status: PENDING -> APPROVED)
2
Genereer ECDH P-256-sleutelpaar (prime256v1)
Publieke sleutel (encryptionPublicKey)Ingesloten in pass.json nfc
PrivésleutelGeprogrammeerd in Secure Element van NFC-lezer (Slot 1..6)
3
Zet NFC entitlement request over op status: PROVISIONED
FASE 02 FASE 2: ISO/IEC 14443 CONTACTLOOS POLLEN & ONTSLEUTELEN
1
Lezer zendt SELECT OSE + SHA-256(pass.com.yourbrand.loyalty) uit
2
iPhone / Apple Watch opent Wallet & controleert requiresAuthentication
3
Apparaat maakt efemere ECDH P-256-sleutel aan, versleutelt 64-byte nfc.message met gedeeld geheim (ANSI X9.63 KDF + AES-256-GCM)
4
Lezer ontsleutelt payload met opgeslagen privésleutelLeest serialNumber
5
Lezer roept POST/api/v1/reader/redeem of POST/api/v1/reader/validate aan

Verplichte vereisten (strikte naleving)

Belangrijk: Apple VAS wordt niet automatisch ingeschakeld bij het aanmaken van een Passinstance-werkruimte of het inschakelen van een NDEF-link. Omdat Apple contactloze Secure Element- en PassKit NFC-transmissies op iOS-kernelniveau beperkt, vereist elke productie-uitrol van Apple VAS drie verplichte onderdelen:

  1. 1
    Goedkeuring van Apple NFC / Enhanced PassKit Entitlement: uw organisatie moet Apple's NFC-Enabled Pass Entitlement aanvragen en ontvangen op uw Apple Developer-account (developer.apple.com/contact/passkit/). Standaard Apple Pass Type ID-certificaten zonder de NFC-entitlementvlag zorgen ervoor dat iOS het nfc-woordenboek in pass.json negeert.
  2. 2
    Passinstance-workflow voor NFC-certificaataanvragen (NFC entitlement request): dien uw NFC-activering in en volg deze (POST /api/v1/certificates/nfc-requests) en koppel lezerapparaten (NFC Settings API), zodat uw publieke versleutelingssleutel correct aan het nfc-woordenboek van uw .pkpass wordt gekoppeld.
  3. 3
    Voor Apple VAS gecertificeerde lezerhardware: balie- of toegangspoortterminals moeten het Apple VAS-protocol implementeren (zoals Certified Apple VAS & Google Smart Tap NFC readers, Verifone of Ingenico VAS-geschikte terminals) en zijn geconfigureerd met de SHA-256-hash van uw passTypeIdentifier en de bijbehorende ECDH P-256-ontsleutelingsprivésleutel.

Levenscyclus & statussen van NFC entitlement request (NfcCertificateRequestStatus)

Passinstance volgt de Apple VAS-entitlementaanvraag van uw werkruimte via het model NFC entitlement request (NfcCertificateRequestStatus):

Status (NfcCertificateRequestStatus)Operationele betekenis
PENDINGDe werkruimte heeft een Apple NFC/VAS-aanvraag ingediend en wacht op beoordeling en goedkeuring van het recht.
APPROVEDEntitlementaanvraag goedgekeurd; klaar om het NFC-gerechtigde TYPE_NFC Apple-certificaat uit te geven/te uploaden.
REJECTEDAanvraag geweigerd of ingediende verificatie van Apple Team / Pass Type ID was onvolledig.
PROVISIONEDNFC-gerechtigde Pass Type Certificate (CertificateType.TYPE_NFC) en versleutelingssleutels zijn actief in Passinstance.

API-endpoints voor Apple VAS & NFC-aanvragen (NFC Request API)

MethodeEndpoint-padVereiste machtigingBeschrijving
POST/api/v1/certificates/nfc-requestscertificates:manageMaakt een nieuw NFC entitlement request aan (status: PENDING) via request payload.
GET/api/v1/certificates/nfc-requestscertificates:readGeeft een overzicht van alle NFC entitlement request-records voor uw werkruimte.
GET/api/v1/certificates/nfc-requests/:idcertificates:readHaalt details en de huidige beoordelingsstatus op voor een specifieke NFC-certificaataanvraag.
POST/api/v1/certificates/nfc-requests/:id/reviewPlatform AdminBeoordeelt/wijzigt de aanvraagstatus (APPROVED, REJECTED, PROVISIONED) via request payload.
POST/api/v1/nfc/testAuthenticatedVoert een test uit op de NFC-paspayload en -configuratie voor een sjabloon.

Voorbeeld: een NFC entitlement request aanmaken (request payload)

JSON
POST /api/v1/certificates/nfc-requests
{
  "organizationName": "Phenix Roasters GmbH",
  "appleTeamId": "9A8B7C6D5E",
  "passTypeId": "pass.com.phenixroasters.loyalty",
  "websiteUrl": "https://phenixroasters.com",
  "useCaseDescription": "In-store loyalty tap redemption on NFC Terminal readers across 45 cafes",
  "contactEmail": "nfc-admin@phenixroasters.com"
}

Antwoord (201 Created):

JSON
{
  "id": "nfcreq_01J9Z8A2B4C6D8E0F2G4H6J8",
  "organizationName": "Phenix Roasters GmbH",
  "appleTeamId": "9A8B7C6D5E",
  "passTypeId": "pass.com.phenixroasters.loyalty",
  "status": "PENDING",
  "createdAt": "2026-11-15T12:00:00.000Z"
}

Hulp nodig bij het afbakenen van Apple VAS voor een uitrol over meerdere vestigingen of voor toegangscontrole? Neem contact op met support of bekijk NFC-pasconfiguratie 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.