Skip to content
Help Center Guide · NFC & Contactless
3 min readVerified 2026-11-16

Apple VAS

Requirements for Apple Value Added Services (VAS): Apple VAS certificate entitlement, merchant request workflow, and supported readers.

In This Guide

What Is Apple Value Added Services (VAS)?

Apple Value Added Services (VAS) is Apple's contactless NFC communication protocol built on ISO/IEC 14443 Type A/B (13.56 MHz). It enables an encrypted pass payload (nfc.message, up to 64 bytes) stored in Apple Wallet on an iPhone or Apple Watch to transmit wirelessly when held near an Apple-certified contactless reader — without waking the screen to display a barcode and without accidentally charging an Apple Pay credit or debit card.

SYSTEM ARCHITECTURE FLOW
INTERACTIVE ARCHITECTURE
APPLE VAS ENTITLEMENT & ECDH P-256 HANDSHAKE
STAGE 01 PHASE 1: ENTITLEMENT & KEY PROVISIONING (NFC entitlement request)
1
Merchant requests Apple NFC Entitlement (status: PENDING -> APPROVED)
2
Generate ECDH P-256 Key Pair (prime256v1)
Public Key (encryptionPublicKey)Embedded in pass.json nfc dict
Private KeyProvisioned into NFC Reader Secure Element (Slot 1..6)
3
Transition NFC entitlement requeststatus: PROVISIONED
STAGE 02 PHASE 2: ISO/IEC 14443 CONTACTLESS POLLING & DECRYPTION
1
Reader broadcasts SELECT OSE + SHA-256(pass.com.yourbrand.loyalty)
2
iPhone / Apple Watch wakes Wallet & checks requiresAuthentication (Face ID)
3
Device generates ephemeral ECDH P-256 key, encrypts 64-byte nfc.message using shared secret (ANSI X9.63 KDF + AES-256-GCM)
4
Reader decrypts payload with stored Private KeyExtracts serialNumber
5
Reader calls POST/api/v1/reader/redeem or POST/api/v1/reader/validate

Required Prerequisites (Strict Compliance)

Important: Apple VAS is not turned on automatically when creating a Passinstance workspace or toggling an NDEF link. Because Apple restricts contactless Secure Element / PassKit NFC transmission at the iOS kernel level, every production Apple VAS deployment requires three mandatory components:

  1. 1
    Apple NFC / Enhanced PassKit Entitlement Approval: Your organization must apply for and receive Apple's NFC-Enabled Pass Entitlement from Apple on your Apple Developer account (developer.apple.com/contact/passkit/). Standard Apple Pass Type ID certificates without the NFC entitlement flag cause iOS to ignore the nfc dictionary inside pass.json.
  2. 2
    Passinstance NFC Certificate Request Workflow (NFC entitlement request): Submit and track your NFC activation (POST /api/v1/certificates/nfc-requests) and pair reader devices (NFC Settings API) so your public encryption key binds cleanly to your .pkpass nfc dictionary.
  3. 3
    Apple VAS-Certified Reader Hardware: Counter or turnstile terminals must implement the Apple VAS protocol configured with the SHA-256 hash of your passTypeIdentifier and the matching ECDH P-256 private decryption key.

NFC entitlement request Lifecycle & Statuses (NfcCertificateRequestStatus)

Passinstance tracks your workspace's Apple VAS entitlement request through the NFC entitlement request model (NfcCertificateRequestStatus):

Status (NfcCertificateRequestStatus)Operational Meaning
PENDINGWorkspace has submitted an Apple NFC/VAS request; awaiting entitlement review and approval.
APPROVEDEntitlement request approved; ready to issue/upload the NFC-entitled TYPE_NFC Apple certificate.
REJECTEDRequest declined or submitted Apple Team / Pass Type ID verification was incomplete.
PROVISIONEDNFC-entitled Pass Type Certificate (CertificateType.TYPE_NFC) and encryption keys are active in Passinstance.

Apple VAS & NFC Request API Endpoints (NFC Request API)

MethodEndpoint PathPermission RequiredDescription
POST/api/v1/certificates/nfc-requestscertificates:manageCreates a new NFC entitlement request (status: PENDING) using request payload.
GET/api/v1/certificates/nfc-requestscertificates:readLists all NFC entitlement request records for your workspace.
GET/api/v1/certificates/nfc-requests/:idcertificates:readRetrieves details and current review status for a specific NFC certificate request.
POST/api/v1/certificates/nfc-requests/:id/reviewPlatform AdminReviews/transitions request status (APPROVED, REJECTED, PROVISIONED) via request payload.
POST/api/v1/nfc/testAuthenticatedExecutes an NFC pass payload/configuration test for a template.

Example: Creating an 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"
}

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

Need assistance scoping Apple VAS for a multi-store or access-control rollout? Contact Support or review NFC Pass Configuration and Compatible NFC Readers.

Related Product & Developer Documentation

Ready to launch your first pass program?

Create your workspace, configure your pass template, and test a real pass in Apple Wallet and Google Wallet before you scale.