Was ist Apple Value Added Services (VAS)?
Apple Value Added Services (VAS) ist Apples kontaktloses NFC-Kommunikationsprotokoll auf Basis von ISO/IEC 14443 Typ A/B (13,56 MHz). Damit kann ein verschlüsseltes Pass-Payload (nfc.message, bis zu 64 Bytes) aus Apple Wallet auf einem iPhone oder einer Apple Watch drahtlos übertragen werden, sobald das Gerät an ein Apple-zertifiziertes kontaktloses Lesegerät gehalten wird — ohne dass der Bildschirm entsperrt werden muss, um einen Barcode anzuzeigen, und ohne versehentlich eine Apple-Pay-Kredit- oder Debitkarte zu belasten.
Zwingende Voraussetzungen (strikte Compliance)
Wichtig: Apple VAS ist nicht automatisch aktiviert, wenn Sie einen Passinstance-Workspace anlegen oder einen NDEF-Link erstellen. Da Apple die kontaktlose Secure-Element-/PassKit-NFC-Übertragung auf Ebene des iOS-Kernels einschränkt, erfordert jeder produktive Einsatz von Apple VAS zwingend drei Komponenten:
-
1
Freigabe des Apple NFC / Enhanced PassKit Entitlement: Ihr Unternehmen muss über seinen Apple-Developer-Account das NFC-Enabled Pass Entitlement direkt bei Apple beantragen und genehmigt bekommen (
developer.apple.com/contact/passkit/). Bei Standard-Pass-Type-ID-Zertifikaten ohne NFC-Berechtigung ignoriert iOS dasnfc-Dictionary innerhalb vonpass.json. -
2
Passinstance NFC-Zertifikatsantrag (
NFC entitlement request): Reichen Sie Ihre NFC-Aktivierung ein (POST /api/v1/certificates/nfc-requests) und verknüpfen Sie Ihre Lesegeräte (NFC Settings API), sodass Ihr öffentlicher Verschlüsselungsschlüssel sauber an dasnfc-Dictionary Ihrer.pkpass-Dateien gebunden wird. -
3
Apple-VAS-zertifizierte Lesegeräte-Hardware: Kassen- oder Drehkreuz-Terminals müssen das Apple-VAS-Protokoll unterstützen und mit dem SHA-256-Hash Ihres
passTypeIdentifiersowie dem passenden privaten ECDH-P-256-Entschlüsselungsschlüssel konfiguriert sein.
Lebenszyklus & Status von NFC entitlement request (NfcCertificateRequestStatus)
Passinstance verfolgt den Apple-VAS-Antrag Ihres Workspaces über das Modell NFC entitlement request (NfcCertificateRequestStatus):
Status (NfcCertificateRequestStatus) | Operative Bedeutung |
|---|---|
PENDING | Workspace hat einen Apple-NFC-/VAS-Antrag eingereicht; Prüfung und Freigabe stehen noch aus. |
APPROVED | Berechtigungsantrag genehmigt; bereit zum Ausstellen und Hochladen des NFC-fähigen Apple-Zertifikats TYPE_NFC. |
REJECTED | Antrag abgelehnt oder die übermittelte Prüfung von Apple Team ID / Pass Type ID war unvollständig. |
PROVISIONED | NFC-fähiges Pass-Type-Zertifikat (CertificateType.TYPE_NFC) und Verschlüsselungsschlüssel sind in Passinstance aktiv. |
API-Endpunkte für Apple VAS & NFC-Anträge (NFC Request API)
| Methode | Endpunkt-Pfad | Erforderliche Berechtigung | Beschreibung |
|---|---|---|---|
| POST | /api/v1/certificates/nfc-requests | certificates:manage | Erstellt einen neuen NFC entitlement request (status: PENDING) über request payload. |
| GET | /api/v1/certificates/nfc-requests | certificates:read | Listet alle NFC entitlement request-Datensätze Ihres Workspaces auf. |
| GET | /api/v1/certificates/nfc-requests/:id | certificates:read | Ruft Details und den aktuellen Prüfstatus für einen bestimmten NFC-Zertifikatsantrag ab. |
| POST | /api/v1/certificates/nfc-requests/:id/review | Plattform-Admin | Prüft bzw. aktualisiert den Antragsstatus (APPROVED, REJECTED, PROVISIONED) über request payload. |
| POST | /api/v1/nfc/test | Authentifiziert | Führt einen Test des NFC-Pass-Payloads und der Konfiguration für eine Vorlage aus. |
Beispiel: NFC entitlement request anlegen (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"
}
Antwort (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"
}
Benötigen Sie Unterstützung bei der Planung von Apple VAS für mehrere Filialen oder Zutrittskontrollen? Kontaktieren Sie den Support oder lesen Sie NFC-Pass-Konfiguration sowie Kompatible NFC-Lesegeräte.
