En esta página, se describen los identificadores que utiliza el protocolo de Toque inteligente.
Descripción general
El protocolo de toque inteligente comunica información sobre un pase guardado en la app de la Billetera de Google de un usuario y la aplicación de la terminal. En el siguiente gráfico, se resume el flujo de comunicación entre la terminal y la Billetera de Google:
Dado que los comercios pueden recurrir a varias empresas o contratistas para desarrollar sus pases, Google usa tres identificadores para facilitar el envío de información entre la Billetera de Google y las terminales. De esta manera, los comercios que usan un proveedor de terminal en particular pueden canjear pases de diferentes desarrolladores. Los siguientes IDs son los tres "identificadores de recopilación" que se usan en el protocolo de Toque inteligente.
ID de la entidad emisora de canje
El ID de la entidad emisora de canje es un tipo específico de ID de la entidad emisora. Por lo general, un ID de entidad emisora de canje representa a un solo comercio. Por el contrario, un ID de entidad emisora para un desarrollador de pases podría representar una plataforma que almacena clases de pases para muchos comercios diferentes. Una plataforma que almacena clases de pase para varios comercios también se conoce como agregador.
Las entidades emisoras de canje no se usan solo para el Toque inteligente. Por ejemplo, las entidades emisoras de canje también se usan para renderizar recordatorios de notificaciones basadas en la ubicación geográfica, según las ubicaciones de la entidad emisora. Por lo tanto, es posible que un ID de entidad emisora que aparece como Emisor de canjes en un pase no se configure para el toque inteligente.
Comparación entre el ID de la entidad emisora y el ID de la entidad emisora del canje
El ID de la entidad emisora es un identificador único de la cuenta de la entidad emisora de la Billetera de Google. Puedes encontrar el ID de la entidad emisora en la consola de Google Pay y la Billetera.
Una entidad emisora puede representar a un comercio (como un restaurante), a un proveedor de ofertas o a un fabricante de terminales, entre otros. Cuando se desarrollan las clases y los objetos de pase, se vinculan a un ID de emisor específico. El ID de emisor se incluye tanto en los IDs de clase de pase como los IDs de objeto.
| ID | Formato | Notas |
|---|---|---|
| ID de clase | issuerId.classSuffix
|
classSuffix es un valor único definido por el desarrollador para una clase de pase específica (p.ej., un nivel de lealtad) |
| ID de objeto | issuerId.objectSuffix
|
objectSuffix es un valor único definido por el desarrollador para un objeto de pase específico (como un ID de usuario). |
Una entidad emisora puede crear todas las clases que necesite.
ID del colector
Si un comercio admite el Toque inteligente en sus terminales, la entidad emisora de canje tendrá un ID de recaudador. El ID de colector es un ID numérico (8 dígitos) que usan las terminales para identificarse. Dado que una entidad emisora de canjes puede admitir varios comercios, el ID de recaudador se usa para solicitar el pase de un comercio específico.
Cuando un usuario acerca su dispositivo a una terminal compatible con el toque inteligente, la terminal envía el ID del colector al dispositivo del usuario. Luego, el dispositivo se autentica con la terminal mediante la clave pública para ese ID de colector. Consulta Flujo de comunicación para obtener más información.
Notas importantes:
- Solo se asigna un ID de recaudador a un ID de entidad emisora
- El ID de recaudador es único entre todos los IDs de entidad emisora.
Si quieres obtener un ID de recaudador para tu ID de entidad emisora, consulta la configuración del comercio.
ID de clase de pase
Un ID de clase identifica un nivel o tipo de pase en particular. Un ID de clase tiene el siguiente formato:
issuerId.classSuffix
El sufijo de la clase es un valor definido por el desarrollador único para esta clase de pase. Se guarda un objeto de pase que hace referencia a este ID de clase en la app de la Billetera de Google del usuario.