In questa pagina vengono descritti gli identificatori utilizzati dal protocollo Smart Tap.
Panoramica
Il protocollo Smart Tap comunica informazioni su una tessera salvata nell'app Google Wallet e nell'applicazione terminale di un utente. L'immagine che segue riassume il flusso di comunicazione tra il terminale e Google Wallet:
Poiché i commercianti possono rivolgersi a più attività o contrattisti per sviluppare le proprie tessere, Google utilizza tre identificatori per facilitare l'invio di informazioni tra Google Wallet e i terminali. Ciò consente ai commercianti che utilizzano un determinato provider di terminali di utilizzare le tessere di diversi sviluppatori. I seguenti ID sono i tre "identificatori di raccolta" utilizzati nel protocollo Smart Tap.
ID emittente di utilizzo
Un ID emittente di utilizzo è un tipo specifico di ID emittente. Un ID emittente di utilizzo in genere rappresenta un singolo commerciante. Al contrario, un ID emittente per uno sviluppatore di pass potrebbe rappresentare una piattaforma che archivia le classi di pass per molti commercianti diversi. Una piattaforma che memorizza i pass per più commercianti è detta anche aggregatore.
Gli emittenti di promozioni vengono utilizzati non solo per Smart Tap. Ad esempio, gli Emittenti di riscatto vengono utilizzati anche per visualizzare promemoria di notifica basati su dati geografici in base alla posizione dell'Emittente. Di conseguenza, un ID emittente indicato come Emittente di utilizzo su una tessera potrebbe non essere configurato per Smart Tap.
ID emittente di utilizzo rispetto all'ID emittente
Un ID emittente è un identificatore univoco di un account emittente di Google Wallet. L'ID emittente è disponibile nella console Google Pay & Wallet.
Un emittente può rappresentare un commerciante (ad esempio un ristorante), un fornitore di offerte o un produttore di terminali e altro ancora. Quando vengono sviluppati oggetti e classi di pass, sono collegati a un ID emittente specifico. L'ID emittente è incluso sia negli ID classe di trasmissione sia negli ID oggetto.
| ID | Formato | Note |
|---|---|---|
| ID classe | issuerId.classSuffix
|
classSuffix è un valore univoco definito dallo sviluppatore per una classe di pass specifica (ad es. un livello fedeltà) |
| ID oggetto | issuerId.objectSuffix
|
objectSuffix è un valore univoco, definito dallo sviluppatore, per uno specifico oggetto pass (come un ID utente) |
Un emittente può creare tutti i corsi di cui ha bisogno.
ID raccoglitore
Se un commerciante supporta la tecnologia Smart Tap presso i suoi terminali, l'emittente delle promozioni disporrà di un ID collezionista. L'ID raccoglitore è un ID numerico (8 cifre) che i terminali utilizzano per identificarsi. Poiché un Emittente con promozioni potrebbe supportare più commercianti, l'ID commerciante viene utilizzato per richiedere il pass di uno specifico commerciante.
Quando un utente tocca il proprio dispositivo a un terminale che supporta Smart Tap, il terminale invia l'ID raccoglitore al dispositivo dell'utente. Il dispositivo si autentica con il terminale utilizzando la chiave pubblica per l'ID raccoglitore. Per ulteriori informazioni, consulta Flusso di comunicazione.
Note importanti:
- A un ID emittente sia assegnato un solo ID raccoglitore
- Un ID raccoglitore è univoco tra tutti gli ID emittente
Per ottenere un ID raccoglitore per il tuo ID emittente, consulta Configurazione commerciante.
Pass ID corso
Un ID classe identifica un determinato livello o tipo di tessera. Un ID classe ha il formato seguente:
issuerId.classSuffix
Il suffisso della classe è un valore definito dallo sviluppatore univoco per questa classe di pass. Un oggetto della tessera che fa riferimento a questo ID corso viene salvato nell'app Google Wallet di un utente.