Skip to content
Guide du centre d'aide · NFC & sans contact
3 min de lectureVérifié 2026-11-16

Apple VAS

Prérequis d'Apple Value Added Services (VAS) : certificat VAS, droits marchand et lecteurs sans contact compatibles.

Dans ce guide

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.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
HABILITATION APPLE VAS & POIGNÉE DE MAIN ECDH P-256
ÉTAPE 01 PHASE 1 : HABILITATION & PROVISIONNEMENT DES CLÉS (NFC entitlement request)
1
Le marchand demande l'habilitation Apple NFC (status: PENDING -> APPROVED)
2
Génération de la paire ECDH P-256 (prime256v1)
Clé publique (encryptionPublicKey)Injectée dans pass.json (nfc)
Clé privéeChargée dans le Secure Element du lecteur NFC (Slot 1..6)
3
Passage de NFC entitlement requeststatus: PROVISIONED
ÉTAPE 02 PHASE 2 : INTERROGATION ISO/IEC 14443 & DÉCHIFFREMENT
1
Le lecteur diffuse SELECT OSE + SHA-256(pass.com.yourbrand.loyalty)
2
L'iPhone / Apple Watch active Cartes & vérifie requiresAuthentication (Face ID)
3
L'appareil génère une clé éphémère ECDH P-256, chiffre les 64 octets (ANSI X9.63 KDF + AES-256-GCM)
4
Le lecteur déchiffre avec sa clé privéeExtrait le serialNumber
5
Le lecteur appelle POST/api/v1/reader/redeem ou POST/api/v1/reader/validate

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. 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 dictionnaire nfc dans pass.json.
  2. 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 dictionnaire nfc des archives .pkpass.
  3. 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 passTypeIdentifier et 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
PENDINGL'espace de travail a soumis une demande Apple NFC/VAS ; en attente de vérification et d'approbation.
APPROVEDDemande d'habilitation approuvée ; prêt pour émettre/importer le certificat Apple TYPE_NFC doté du droit NFC.
REJECTEDDemande refusée ou vérification Apple Team / Pass Type ID incomplète.
PROVISIONEDLe 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éthodeChemin du point d'entréePermission requiseDescription
POST/api/v1/certificates/nfc-requestscertificates:manageCrée une nouvelle demande NFC entitlement request (status: PENDING) via request payload.
GET/api/v1/certificates/nfc-requestscertificates:readListe l'ensemble des enregistrements NFC entitlement request de l'espace de travail.
GET/api/v1/certificates/nfc-requests/:idcertificates:readRécupère les détails et l'état d'examen d'une demande NFC spécifique.
POST/api/v1/certificates/nfc-requests/:id/reviewAdministrateur plateformeExamine/fait évoluer le statut (APPROVED, REJECTED, PROVISIONED) via request payload.
POST/api/v1/nfc/testAuthentifiéExécute un test de payload/configuration NFC pour un modèle donné.

Exemple : créer une demande NFC entitlement request (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"
}

Réponse (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"
}

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.

Documentation produit et développeur associée

Prêt à lancer votre premier programme de cartes Wallet ?

Créez votre espace de travail, configurez votre modèle et testez une vraie carte dans Apple Wallet et Google Wallet avant de déployer à grande échelle.