En esta página, se describen los identificadores que usa el protocolo del toque inteligente.
Descripción general
El protocolo del toque inteligente comunica información sobre un pase guardado a la cuenta del usuario la app de la Billetera de Google 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:
Debido a 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 Google Wallet y terminales. Esto permite que los comercios que usen una terminal en particular para canjear pases de diferentes desarrolladores. Los siguientes IDs son los tres “identificadores de colecciones” que se usa en el protocolo del toque inteligente.
ID de la entidad emisora que realiza el canje
El ID de la entidad emisora de canjes es un tipo específico de ID de la entidad emisora. Un ID de la entidad emisora de canjes normalmente representa a un solo comercio. En cambio, el ID de la entidad emisora de una desarrollador de pases podría representar una plataforma en la que las tiendas estén aprobadas para muchas diferentes comercios. Una plataforma que almacena pases de clases para varios comercios también se conoce como agregador.
Las entidades emisoras de canje no solo se usan para el Toque inteligente. Por ejemplo: Las entidades emisoras de canje también se usan para procesar recordatorios basados en la ubicación geográfica. según las ubicaciones de la entidad emisora del canje. Por lo tanto, el ID de la entidad emisora aparece como Es posible que la entidad emisora de canjes de un pase no esté configurada para el Toque inteligente.
Comparación entre el ID de la entidad emisora de canje y el ID de la entidad emisora
Un ID de emisor es un identificador único de una cuenta de entidad emisora de Google Wallet. El Puedes encontrar el ID de la entidad emisora Google Pay y Consola de la Billetera.
Una entidad emisora puede representar a un comercio (como un restaurante), a un proveedor de ofertas o un fabricante de terminales y mucho más. Cuando se desarrollan objetos y clases de pase, están vinculados a un ID de entidad emisora específico. El ID de la entidad emisora se incluye en ambos pases los IDs de clase y los IDs de objeto.
| ID | Formato | Notas |
|---|---|---|
| ID de clase | issuerId.classSuffix
|
El classSuffix es un
definido por el desarrollador para un valor
clase de pase (p.ej., un nivel de lealtad) |
| ID de objeto | issuerId.objectSuffix
|
El objectSuffix es un
definido por el desarrollador para un valor
un objeto de pase (como un ID de usuario) |
Una entidad emisora puede crear tantas clases como necesite.
ID del colector
Si un comercio admite Smart Tap en sus terminales, la entidad emisora de canjes tendrá un ID de recaudador. El ID de recaudador es un ID numérico (8 dígitos) que terminales usan para identificarse. Debido a que una entidad emisora de canjes puede admitir varios comercios, el ID de recaudador se usa para solicitar el ID de un comercio específico que el pase.
Cuando un usuario acerca su dispositivo a un terminal compatible con Smart Tap, la terminal envía el ID del colector al dispositivo del usuario. Luego, el dispositivo se autentica con en la terminal con la clave pública correspondiente a ese ID de recaudador. 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
- Los IDs de recaudador son únicos para todos los IDs de entidades emisoras
Si quieres obtener un ID de recaudador para tu ID de entidad emisora, consulta Configuración del comercio.
ID de clase del pase
Un ID de clase identifica un nivel o tipo de pase específico. Un ID de clase sigue la a continuación:
issuerId.classSuffix
El sufijo de la clase es un valor definido por el desarrollador que es único para esta clase de pase. Pase objeto que hace referencia a este ID de clase se guarda en la app de la Billetera de Google del usuario.