Skip to content
Hilfecenter-Anleitung · NFC & Kontaktlos
3 Min. LesezeitGeprüft 2026-11-16

Apple VAS

Voraussetzungen für Apple Value Added Services (VAS): VAS-Zertifikatserweiterung, Händlerantrag und kompatible Lesegeräte.

In dieser Anleitung

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.

SYSTEMARCHITEKTUR-ABLAUF
INTERAKTIVE ARCHITEKTUR
APPLE-VAS-BERECHTIGUNG & ECDH-P-256-HANDSHAKE
STUFE 01 PHASE 1: BERECHTIGUNG & SCHLÜSSELVERWALTUNG (NFC entitlement request)
1
Händler beantragt Apple-NFC-Entitlement (status: PENDING -> APPROVED)
2
ECDH-P-256-Schlüsselpaar (prime256v1) erzeugen
Public Key (encryptionPublicKey)Eingebettet im nfc-Dict (pass.json)
Private KeyHinterlegt im Secure Element des NFC-Readers (Slot 1..6)
3
NFC entitlement request geht über instatus: PROVISIONED
STUFE 02 PHASE 2: KONTAKTLOSES ISO/IEC-14443-POLLING & ENTSCHLÜSSELUNG
1
Reader sendet SELECT OSE + SHA-256(pass.com.yourbrand.loyalty)
2
iPhone / Apple Watch weckt Wallet & prüft requiresAuthentication (Face ID)
3
Gerät erzeugt ephemeren ECDH-P-256-Key & verschlüsselt 64-Byte nfc.message per Shared Secret (ANSI X9.63 KDF + AES-256-GCM)
4
Reader entschlüsselt Payload mit Private KeyExtrahiert serialNumber
5
Reader ruft POST/api/v1/reader/redeem oder POST/api/v1/reader/validate auf

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. 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 das nfc-Dictionary innerhalb von pass.json.
  2. 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 das nfc-Dictionary Ihrer .pkpass-Dateien gebunden wird.
  3. 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 passTypeIdentifier sowie 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
PENDINGWorkspace hat einen Apple-NFC-/VAS-Antrag eingereicht; Prüfung und Freigabe stehen noch aus.
APPROVEDBerechtigungsantrag genehmigt; bereit zum Ausstellen und Hochladen des NFC-fähigen Apple-Zertifikats TYPE_NFC.
REJECTEDAntrag abgelehnt oder die übermittelte Prüfung von Apple Team ID / Pass Type ID war unvollständig.
PROVISIONEDNFC-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)

MethodeEndpunkt-PfadErforderliche BerechtigungBeschreibung
POST/api/v1/certificates/nfc-requestscertificates:manageErstellt einen neuen NFC entitlement request (status: PENDING) über request payload.
GET/api/v1/certificates/nfc-requestscertificates:readListet alle NFC entitlement request-Datensätze Ihres Workspaces auf.
GET/api/v1/certificates/nfc-requests/:idcertificates:readRuft Details und den aktuellen Prüfstatus für einen bestimmten NFC-Zertifikatsantrag ab.
POST/api/v1/certificates/nfc-requests/:id/reviewPlattform-AdminPrüft bzw. aktualisiert den Antragsstatus (APPROVED, REJECTED, PROVISIONED) über request payload.
POST/api/v1/nfc/testAuthentifiziertFührt einen Test des NFC-Pass-Payloads und der Konfiguration für eine Vorlage aus.

Beispiel: NFC entitlement request anlegen (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"
}

Antwort (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"
}

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.

Weiterführende Produkt- & Entwicklerdoku

Bereit für Ihr erstes Wallet-Kartenprogramm?

Erstellen Sie Ihren Workspace, konfigurieren Sie Ihre Vorlage und testen Sie eine echte Karte in Apple Wallet und Google Wallet, bevor Sie skalieren.