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

Google Smart Tap

Prérequis Google Smart Tap : Collector ID, clés publique/privée et réglage terminal NFC_SMART_TAP.

Dans ce guide

Qu'est-ce que Google Smart Tap ?

Google Smart Tap (NFC_SMART_TAP) est le protocole de lecture sans contact chiffrée NFC de Google Wallet reposant sur la négociation de services NDEF sur ISO-DEP / NFC Forum Type 4 Tag. Il permet aux smartphones Android de transmettre une carte de fidélité, offre, carte cadeau, billet d'événement ou passe générique via NFC à 13,56 MHz directement vers un terminal de caisse ou d'accès compatible, sans obliger l'utilisateur à ouvrir et orienter un code-barres à l'écran.

FLUX ARCHITECTURE SYSTÈME
ARCHITECTURE INTERACTIVE
NÉGOCIATION GOOGLE SMART TAP NDEF & ECDH P-256
ÉTAPE 01 PHASE 1 : LIAISON ÉMETTEUR, COLLECTOR ID & CLÉ DE CLASSE
1
Configurer smartTapMerchantId & collectorId (8 chiffres hex/entier) via POST/api/v1/google-wallet/setup
2
Enregistrer clé publique ECDH P-256 + version dans le compte Émetteur Google
3
Activer Smart Tap sur Class (enableSmartTap: true, redemptionIssuers)
4
Remplir smartTapRedemptionValue sur chaque Object (LoyaltyObject, etc.)
ÉTAPE 02 PHASE 2 : NÉGOCIATION SANS CONTACT NDEF (NFC_SMART_TAP)
1
Le lecteur sélectionne l'AID Smart Tap (A000000476D0000111) sur ISO-DEP
2
Négocie la session NDEF (Negotiate SmartTap Request + clé éphémère lecteur)
3
Android vérifie collectorId, signe & chiffre smartTapRedemptionValue avec secret partagé ECDH P-256 + AES-128-CTR / HMAC-SHA256
4
Le lecteur déchiffreAppelle le moteur de validation Passinstance (readerType: "NFC_SMART_TAP"POST/api/v1/reader/redeem ou /scans)

Prérequis & paramètres de configuration

Prérequis : Pour exploiter Google Smart Tap (NFC_SMART_TAP) sur vos sites physiques, votre Google Wallet Class doit déclarer vos redemptionIssuers autorisés (issuerId), votre terminal doit diffuser le collectorId 32 bits correspondant et votre configuration de validation Passinstance doit activer le mode lecteur NFC_SMART_TAP.

  1. 1
    Collector ID dans Google Pay & Wallet Business Console (collectorId) : Paramétrez un Collector ID numérique unique (et smartTapMerchantId) sur votre profil émetteur Google Wallet puis importez votre clé publique ECDH P-256 (prime256v1) compressée accompagnée d'un numéro de version entier (ex. 1).
  2. 2
    Hydratation automatique Class & Object : Lorsque nfcEnabled: true est actif sur un modèle Passinstance, celui-ci renseigne automatiquement enableSmartTap: true et redemptionIssuers: ["<issuerId>"] sur la Google Wallet Class, et inscrit le serialNumber (ou le message NFC personnalisé) dans smartTapRedemptionValue de chaque Object émis.
  3. 3
    Appairage du terminal lecteur : Chargez le même collectorId, le numéro de version de clé et la clé privée ECDH P-256 dans le profil de votre caisse ou lecteur certified NFC.
  4. 4
    Réglage du lecteur dans Passinstance (NFC_SMART_TAP) : Définissez le mode lecteur sur NFC_SMART_TAP (ou AUTO pour le double protocole VAS + Smart Tap) sous Configuration de validation -> Paramètres NFC en lien avec votre lieu de validation, afin que les passages sans contact exécutent exactement le même moteur à 14 règles et mécaniques que les scans optiques.

Schéma Google Wallet Class & Object pour Smart Tap

Lorsque Passinstance synchronise un modèle et un passe compatibles Smart Tap vers l'API walletobjects/v1 de Google, les champs de protocole suivants sont renseignés :

JSON
{
  "loyaltyClass": {
    "id": "3388000000022194812.cls_7b9e4c12",
    "issuerName": "Phenix Roasters",
    "programName": "VIP Coffee Club",
    "enableSmartTap": true,
    "redemptionIssuers": [
      "3388000000022194812"
    ]
  },
  "loyaltyObject": {
    "id": "3388000000022194812.pass_c41a8d20",
    "classId": "3388000000022194812.cls_7b9e4c12",
    "state": "ACTIVE",
    "smartTapRedemptionValue": "PI-8849-2026-X9",
    "barcode": {
      "type": "QR_CODE",
      "value": "PI-8849-2026-X9"
    }
  }
}

Référence API de configuration & validation Smart Tap

MéthodeChemin du point d'entréeDescription
POST/api/v1/google-wallet/setupConfigure votre compte émetteur Google Wallet et provisionne votre collectorId & smartTapMerchantData Smart Tap.
GET/api/v1/google-wallet/statusRetourne { isConfigured, collectorId } pour l'installation Google Wallet & Smart Tap de votre espace.
PUT/api/v1/reader/validateConfigure les clés collecteur Smart Tap / VAS des lecteurs matériels et les valeurs NFC par défaut de l'espace.
POST/api/v1/reader/redeemTraite une charge utile de validation sans contact déchiffrée par lecteur (X-Reader-Secret, request payload).

Exemple : vérifier le Collector ID Smart Tap provisionné

BASH
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>

Réponse (200 OK) :

JSON
{
  "isConfigured": true,
  "collectorId": "50992104"
}

Paramétrez le même collectorId et les emplacements de clés ECDH sur votre matériel via Paramètres -> Wallet -> NFC (/settings/workspace/wallet/nfc) ou téléchargez directement un fichier config.txt prêt pour NFC via GET /api/v1/reader/devices/:id/config-file.

Conservez toujours un code-barres optique de secours

Même lorsque NFC_SMART_TAP est actif sur toutes vos caisses, laissez un code QR ou Aztec 2D activé sur la mise en page (nfcNoBarcode: false) afin que les clients utilisant un smartphone Android plus ancien ou ayant désactivé le NFC puissent toujours présenter leur carte optiquement.

Consultez Configuration des passes NFC, Apple VAS et Lecteurs NFC compatibles.

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.