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.
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
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 hetnfc-woordenboek inpass.jsonnegeert. -
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 hetnfc-woordenboek van uw.pkpasswordt gekoppeld. -
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
passTypeIdentifieren 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 |
|---|---|
PENDING | De werkruimte heeft een Apple NFC/VAS-aanvraag ingediend en wacht op beoordeling en goedkeuring van het recht. |
APPROVED | Entitlementaanvraag goedgekeurd; klaar om het NFC-gerechtigde TYPE_NFC Apple-certificaat uit te geven/te uploaden. |
REJECTED | Aanvraag geweigerd of ingediende verificatie van Apple Team / Pass Type ID was onvolledig. |
PROVISIONED | NFC-gerechtigde Pass Type Certificate (CertificateType.TYPE_NFC) en versleutelingssleutels zijn actief in Passinstance. |
API-endpoints voor Apple VAS & NFC-aanvragen (NFC Request API)
| Methode | Endpoint-pad | Vereiste machtiging | Beschrijving |
|---|---|---|---|
| POST | /api/v1/certificates/nfc-requests | certificates:manage | Maakt een nieuw NFC entitlement request aan (status: PENDING) via request payload. |
| GET | /api/v1/certificates/nfc-requests | certificates:read | Geeft een overzicht van alle NFC entitlement request-records voor uw werkruimte. |
| GET | /api/v1/certificates/nfc-requests/:id | certificates:read | Haalt details en de huidige beoordelingsstatus op voor een specifieke NFC-certificaataanvraag. |
| POST | /api/v1/certificates/nfc-requests/:id/review | Platform Admin | Beoordeelt/wijzigt de aanvraagstatus (APPROVED, REJECTED, PROVISIONED) via request payload. |
| POST | /api/v1/nfc/test | Authenticated | Voert een test uit op de NFC-paspayload en -configuratie voor een sjabloon. |
Voorbeeld: een NFC entitlement request aanmaken (request payload)
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):
{
"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.
