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.
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 vosredemptionIssuersautorisés (issuerId), votre terminal doit diffuser lecollectorId32 bits correspondant et votre configuration de validation Passinstance doit activer le mode lecteurNFC_SMART_TAP.
-
1
Collector ID dans Google Pay & Wallet Business Console (
collectorId) : Paramétrez un Collector ID numérique unique (etsmartTapMerchantId) 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
Hydratation automatique Class & Object : Lorsque
nfcEnabled: trueest actif sur un modèle Passinstance, celui-ci renseigne automatiquementenableSmartTap: trueetredemptionIssuers: ["<issuerId>"]sur la Google Wallet Class, et inscrit leserialNumber(ou le message NFC personnalisé) danssmartTapRedemptionValuede chaque Object émis. -
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
Réglage du lecteur dans Passinstance (
NFC_SMART_TAP) : Définissez le mode lecteur surNFC_SMART_TAP(ouAUTOpour 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 :
{
"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éthode | Chemin du point d'entrée | Description |
|---|---|---|
| POST | /api/v1/google-wallet/setup | Configure votre compte émetteur Google Wallet et provisionne votre collectorId & smartTapMerchantData Smart Tap. |
| GET | /api/v1/google-wallet/status | Retourne { isConfigured, collectorId } pour l'installation Google Wallet & Smart Tap de votre espace. |
| PUT | /api/v1/reader/validate | Configure 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/redeem | Traite 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é
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>
Réponse (200 OK) :
{
"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.
