Che cos'è Apple Value Added Services (VAS)?
Apple Value Added Services (VAS) è il protocollo di comunicazione contactless NFC di Apple basato su ISO/IEC 14443 Tipo A/B (13,56 MHz). Consente a un payload cifrato del pass (nfc.message, fino a 64 byte) archiviato in Apple Wallet su iPhone o Apple Watch di essere trasmesso in modalità wireless quando avvicinato a un lettore contactless certificato Apple — senza dover sbloccare lo schermo per mostrare un codice a barre e senza addebitare accidentalmente una carta di credito o debito Apple Pay.
Prerequisiti obbligatori (conformità rigorosa)
Importante: Apple VAS non viene attivato automaticamente creando un workspace Passinstance o configurando un link NDEF. Poiché Apple limita la trasmissione NFC via Secure Element / PassKit a livello di kernel iOS, ogni distribuzione Apple VAS in produzione richiede tre componenti obbligatori:
-
1
Approvazione Apple NFC / Enhanced PassKit Entitlement: L'organizzazione deve richiedere e ottenere da Apple l'NFC-Enabled Pass Entitlement sul proprio account Apple Developer (
developer.apple.com/contact/passkit/). I certificati Apple Pass Type ID standard privi del flag NFC entitlement portano iOS a ignorare il dizionarionfcdentropass.json. -
2
Flusso richiesta certificato NFC Passinstance (
NFC entitlement request): Invii e tracci la richiesta di attivazione NFC (POST /api/v1/certificates/nfc-requests) e abbini i dispositivi lettore (NFC Settings API) in modo che la propria chiave pubblica di cifratura si leghi correttamente al dizionarionfcdei file.pkpass. -
3
Hardware lettore certificato Apple VAS: I terminali da banco o tornello devono implementare il protocollo Apple VAS (come Certified Apple VAS & Google Smart Tap NFC readers, Verifone o terminali Ingenico abilitati VAS) configurati con l'hash SHA-256 del proprio
passTypeIdentifiere con la corrispondente chiave privata di decifratura ECDH P-256.
Ciclo di vita e stati di NFC entitlement request (NfcCertificateRequestStatus)
Passinstance traccia la richiesta di abilitazione Apple VAS del workspace tramite il modello NFC entitlement request (NfcCertificateRequestStatus):
Stato (NfcCertificateRequestStatus) | Significato operativo |
|---|---|
PENDING | Il workspace ha inviato una richiesta Apple NFC/VAS; in attesa di esame e approvazione dell'entitlement. |
APPROVED | Richiesta di entitlement approvata; pronto per emettere/caricare il certificato Apple TYPE_NFC abilitato NFC. |
REJECTED | Richiesta respinta oppure verifica Apple Team / Pass Type ID inviata incompleta. |
PROVISIONED | Certificato Pass Type abilitato NFC (CertificateType.TYPE_NFC) e chiavi di cifratura attivi in Passinstance. |
Endpoint API per Apple VAS e richieste NFC (NFC Request API)
| Metodo | Percorso endpoint | Permesso richiesto | Descrizione |
|---|---|---|---|
| POST | /api/v1/certificates/nfc-requests | certificates:manage | Crea una nuova NFC entitlement request (status: PENDING) tramite request payload. |
| GET | /api/v1/certificates/nfc-requests | certificates:read | Elenca tutti i record NFC entitlement request per il workspace. |
| GET | /api/v1/certificates/nfc-requests/:id | certificates:read | Recupera dettagli e stato di revisione corrente per una specifica richiesta certificato NFC. |
| POST | /api/v1/certificates/nfc-requests/:id/review | Admin piattaforma | Esamina/fa transitare lo stato della richiesta (APPROVED, REJECTED, PROVISIONED) tramite request payload. |
| POST | /api/v1/nfc/test | Autenticato | Esegue un test di payload/configurazione NFC per un modello. |
Esempio: creazione di una NFC entitlement request (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"
}
Risposta (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"
}
Serve supporto per dimensionare Apple VAS su un rollout multi-negozio o di controllo accessi? Contatti l'assistenza oppure consulti Configurazione pass NFC e Lettori NFC compatibili.
