Skip to content
Helpcentrum-gids · NFC & contactloos
3 min leestijdGecontroleerd 2026-11-16

Google Smart Tap

Vereisten voor Google Smart Tap: Collector ID, sleutelpaar en NFC_SMART_TAP-scannerinstellingen.

In deze gids

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.

SYSTEEMARCHITECTUUR
INTERACTIEVE ARCHITECTUUR
GOOGLE SMART TAP NDEF & ECDH P-256-ONDERHANDELING
FASE 01 FASE 1: ISSUER, COLLECTOR ID & CLASS-SLEUTELKOPPELING
1
Configureer smartTapMerchantId & 8-cijferige hex/int collectorId via POST/api/v1/google-wallet/setup
2
Registreer ECDH P-256 Publieke sleutel + Key Version in Google Wallet Issuer
3
Schakel Smart Tap in op Class (enableSmartTap: true, redemptionIssuers)
4
Vul smartTapRedemptionValue in op elk pasobject (LoyaltyObject, enz.)
FASE 02 FASE 2: CONTACTLOZE NDEF-SERVICEONDERHANDELING (NFC_SMART_TAP)
1
Lezer selecteert Smart Tap AID (A000000476D0000111) over ISO-DEP
2
Onderhandelt NDEF-sessie (Negotiate SmartTap Request + Reader Ephemeral Key)
3
Android-apparaat matcht collectorId, ondertekent & versleutelt payload met gedeeld geheim ECDH P-256 + AES-128-CTR / HMAC-SHA256
4
Lezer ontsleuteltStuurt naar Passinstance-validatie-engine (readerType: "NFC_SMART_TAP"POST/api/v1/reader/redeem of /scans)

Vereisten & configuratieparameters

Vereisten: Om Google Smart Tap (NFC_SMART_TAP) op fysieke locaties te gebruiken, moet uw Google Wallet Class uw geautoriseerde redemptionIssuers (issuerId) vermelden, moet uw terminal de bijbehorende 32-bits collectorId uitzenden en moet uw validatieconfiguratie in Passinstance de lezermodus NFC_SMART_TAP inschakelen.

  1. 1
    Collector ID in Google Pay & Wallet Business Console (collectorId): configureer een unieke numerieke Collector ID (en smartTapMerchantId) 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. 2
    Smart Tap-hydratatie van Class & Object: wanneer nfcEnabled: true actief is op een Passinstance-sjabloon, stelt Passinstance automatisch enableSmartTap: true en redemptionIssuers: ["<issuerId>"] in op de Google Wallet Class, en schrijft het de serialNumber (of het aangepaste NFC-bericht) van de pas naar smartTapRedemptionValue op elk uitgegeven Google Wallet-object.
  3. 3
    Koppeling van de lezerterminal: laad de bijbehorende collectorId, sleutelversie en ECDH P-256-privésleutel in uw POS- of certified NFC-lezerprofiel.
  4. 4
    Passinstance-lezerinstellingen (NFC_SMART_TAP): configureer de lezermodus van het apparaat op NFC_SMART_TAP (of AUTO voor 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:

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

API-referentie voor Smart Tap-configuratie & validatie

MethodeEndpoint-padBeschrijving
POST/api/v1/google-wallet/setupConfigureert uw Google Wallet-issueraccount en richt uw Smart Tap collectorId & smartTapMerchantData in.
GET/api/v1/google-wallet/statusRetourneert { isConfigured, collectorId } voor de Google Wallet- & Smart Tap-configuratie van uw werkruimte.
PUT/api/v1/reader/validateConfigureert Smart Tap- / VAS-hardwarelezersleutels en NFC-standaardwaarden in uw werkruimte-integratie.
POST/api/v1/reader/redeemVerwerkt een door de lezer ontsleutelde tap-inwisselingspayload (X-Reader-Secret, request payload).

Voorbeeld: ingerichte Smart Tap Collector ID controleren

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

Antwoord (200 OK):

JSON
{
  "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.

Klaar om uw eerste kaartprogramma te lanceren?

Maak uw workspace aan, configureer uw sjabloon en test een echte kaart in Apple Wallet en Google Wallet voordat u opschaalt.