Qu'est-ce qu'Apple Value Added Services (VAS) ?
Apple Value Added Services (VAS) est le protocole de communication sans contact NFC d'Apple fondé sur la norme ISO/IEC 14443 Type A/B (13,56 MHz). Il permet à une charge utile chiffrée (nfc.message, jusqu'à 64 octets) stockée dans Apple Wallet sur un iPhone ou une Apple Watch d'être transmise sans fil à proximité d'un lecteur certifié Apple — sans réveiller l'écran pour afficher un code-barres et sans déclencher par erreur le débit d'une carte bancaire Apple Pay.
Prérequis obligatoires (conformité stricte)
Important : Apple VAS n'est pas activé automatiquement lors de la création d'un espace Passinstance ni avec de simples liens NDEF. Parce qu'Apple restreint l'accès au Secure Element sans contact et aux émissions NFC PassKit au niveau du noyau iOS, tout déploiement Apple VAS en production exige impérativement trois éléments :
-
1
Approbation Apple NFC / Enhanced PassKit Entitlement : Votre organisation doit déposer et obtenir auprès d'Apple l'habilitation NFC-Enabled Pass Entitlement pour son compte Apple Developer (
developer.apple.com/contact/passkit/). Un certificat Pass Type ID standard dépourvu de ce drapeau NFC pousse iOS à ignorer purement et simplement le dictionnairenfcdanspass.json. -
2
Demande de certificat NFC dans Passinstance (
NFC entitlement request) : Créez et suivez votre demande d'activation NFC (POST /api/v1/certificates/nfc-requests) puis associez vos lecteurs (NFC Settings API) afin que votre clé publique de chiffrement soit correctement liée au dictionnairenfcdes archives.pkpass. -
3
Matériel lecteur certifié Apple VAS : Vos terminaux comptoir ou portiques d'accès doivent implémenter le protocole Apple VAS (tels que les lecteurs Certified Apple VAS & Google Smart Tap NFC readers, Verifone ou Ingenico compatibles VAS) et être programmés avec l'empreinte SHA-256 de votre
passTypeIdentifieret la clé privée de déchiffrement ECDH P-256 associée.
Cycle de vie & statuts NFC entitlement request (NfcCertificateRequestStatus)
Passinstance suit l'avancement de la demande d'habilitation Apple VAS de votre espace à travers le modèle NFC entitlement request (NfcCertificateRequestStatus) :
Statut (NfcCertificateRequestStatus) | Signification opérationnelle |
|---|---|
PENDING | L'espace de travail a soumis une demande Apple NFC/VAS ; en attente de vérification et d'approbation. |
APPROVED | Demande d'habilitation approuvée ; prêt pour émettre/importer le certificat Apple TYPE_NFC doté du droit NFC. |
REJECTED | Demande refusée ou vérification Apple Team / Pass Type ID incomplète. |
PROVISIONED | Le certificat Pass Type habilité NFC (CertificateType.TYPE_NFC) et les clés de chiffrement sont actifs dans Passinstance. |
Points d'entrée API Apple VAS & demandes NFC (NFC Request API)
| Méthode | Chemin du point d'entrée | Permission requise | Description |
|---|---|---|---|
| POST | /api/v1/certificates/nfc-requests | certificates:manage | Crée une nouvelle demande NFC entitlement request (status: PENDING) via request payload. |
| GET | /api/v1/certificates/nfc-requests | certificates:read | Liste l'ensemble des enregistrements NFC entitlement request de l'espace de travail. |
| GET | /api/v1/certificates/nfc-requests/:id | certificates:read | Récupère les détails et l'état d'examen d'une demande NFC spécifique. |
| POST | /api/v1/certificates/nfc-requests/:id/review | Administrateur plateforme | Examine/fait évoluer le statut (APPROVED, REJECTED, PROVISIONED) via request payload. |
| POST | /api/v1/nfc/test | Authentifié | Exécute un test de payload/configuration NFC pour un modèle donné. |
Exemple : créer une demande 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"
}
Réponse (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"
}
Besoin d'accompagnement pour déployer Apple VAS sur un réseau de boutiques ou un contrôle d'accès ? Contacter le support ou consultez Configuration des passes NFC et Lecteurs NFC compatibles.
