Wat is Google Smart Tap?
Google Smart Tap (NFC_SMART_TAP) is het versleutelde contactloze NFC-presentatieprotocol van Google Wallet op basis van NFC Forum Type 4 Tag / ISO-DEP NDEF-serviceonderhandeling. Hiermee kunnen Android-smartphones een Loyalty-, Offer-, Gift Card-, Event Ticket- of Generic-pasbewijs via 13,56 MHz NFC rechtstreeks naar compatibele kassa- of toegangsterminals verzenden, zonder dat de gebruiker een barcode op het scherm hoeft op te zoeken en te openen.
Vereisten & configuratieparameters
Vereisten: Om Google Smart Tap (
NFC_SMART_TAP) op fysieke locaties te gebruiken, moet uw Google Wallet Class uw geautoriseerderedemptionIssuers(issuerId) vermelden, moet uw terminal de bijbehorende 32-bitscollectorIduitzenden en moet uw validatieconfiguratie in Passinstance de lezermodusNFC_SMART_TAPinschakelen.
-
1
Collector ID in Google Pay & Wallet Business Console (
collectorId): configureer een unieke numerieke Collector ID (ensmartTapMerchantId) in uw Google Wallet Issuer-profiel en upload uw gecomprimeerde publieke ECDH P-256 (prime256v1)-sleutel met een geheel getal voor de sleutelversie (bijv.1). -
2
Smart Tap-hydratatie van Class & Object: wanneer
nfcEnabled: trueactief is op een Passinstance-sjabloon, stelt Passinstance automatischenableSmartTap: trueenredemptionIssuers: ["<issuerId>"]in op de Google Wallet Class, en schrijft het deserialNumber(of het aangepaste NFC-bericht) van de pas naarsmartTapRedemptionValueop elk uitgegeven Google Wallet-object. -
3
Koppeling van de lezerterminal: laad de bijbehorende
collectorId, sleutelversie en ECDH P-256-privésleutel in uw POS- of certified NFC-lezerprofiel. -
4
Passinstance-lezerinstellingen (
NFC_SMART_TAP): configureer de lezermodus van het apparaat opNFC_SMART_TAP(ofAUTOvoor dual-protocol VAS + Smart Tap) onder Validation Configuration -> NFC Settings naast uw validatielocatie, zodat contactloze taps exact dezelfde 14-regelige validatie- en mechanica-engine uitvoeren als optische barcodescans.
Google Wallet Class- & Object-schema voor Smart Tap
Wanneer Passinstance een voor Smart Tap ingeschakeld sjabloon en pas synchroniseert met Google's walletobjects/v1 API, neemt het de volgende protocoleigenschappen op:
{
"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"
}
}
}
API-referentie voor Smart Tap-configuratie & validatie
| Methode | Endpoint-pad | Beschrijving |
|---|---|---|
| POST | /api/v1/google-wallet/setup | Configureert uw Google Wallet-issueraccount en richt uw Smart Tap collectorId & smartTapMerchantData in. |
| GET | /api/v1/google-wallet/status | Retourneert { isConfigured, collectorId } voor de Google Wallet- & Smart Tap-configuratie van uw werkruimte. |
| PUT | /api/v1/reader/validate | Configureert Smart Tap- / VAS-hardwarelezersleutels en NFC-standaardwaarden in uw werkruimte-integratie. |
| POST | /api/v1/reader/redeem | Verwerkt een door de lezer ontsleutelde tap-inwisselingspayload (X-Reader-Secret, request payload). |
Voorbeeld: ingerichte Smart Tap Collector ID controleren
GET /api/v1/google-wallet/status
X-API-Key: <API_KEY>
Antwoord (200 OK):
{
"isConfigured": true,
"collectorId": "50992104"
}
Configureer de bijbehorende collectorId en ECDH-sleutelslots op uw hardwarelezer via Settings -> Wallet -> NFC (/settings/workspace/wallet/nfc) of download een NFC config.txt-bundel via GET /api/v1/reader/devices/:id/config-file.
Houd altijd een optische barcode als terugvaloptie ingeschakeld
Zelfs wanneer NFC_SMART_TAP bij alle kassa's actief is, raden wij aan een standaard 2D QR- of Aztec-barcode op de paslay-out ingeschakeld te laten (nfcNoBarcode: false), zodat klanten met oudere Android-telefoons of uitgeschakelde NFC-instellingen alsnog optisch kunnen scannen.
Bekijk ook NFC-pasconfiguratie, Apple VAS en Compatibele NFC-lezers.
