Nesta página, descrevemos os identificadores usados pelo protocolo de Toque inteligente.
Visão geral
O protocolo de Toque inteligente transmite informações sobre um cartão salvo no app Carteira do Google de um usuário e no aplicativo do terminal. O gráfico a seguir resume o fluxo de comunicação entre o terminal e a Carteira do Google:
Como os comerciantes podem usar várias empresas ou prestadores de serviços para desenvolver os cartões, o Google usa três identificadores para facilitar o envio de informações entre a Carteira do Google e os terminais. Isso permite que os comerciantes que usam um provedor de terminais específico resgatem cartões de diferentes desenvolvedores. Os IDs a seguir são os três "identificadores de coleção" usados no protocolo de Toque inteligente.
ID do emissor de resgate
Um ID do emissor de resgate é um tipo específico de ID do emissor. Ele geralmente representa um único comerciante. Por outro lado, um ID do emissor para um desenvolvedor de cartão pode representar uma plataforma que armazena classes de cartão para muitos comerciantes diferentes. Uma plataforma que armazena classes de cartão para vários comerciantes também é chamada de agregador.
Os emissores de resgate são usados para mais do que apenas o Toque inteligente. Por exemplo, os emissores de resgate também são usados para renderizar lembretes de notificação com base na localização geográfica de acordo com os locais do emissor. Portanto, talvez um ID listado como emissor de resgate em um cartão não esteja configurado para o Toque inteligente.
ID do emissor de resgate x ID do emissor
Um ID do emissor é um identificador exclusivo de uma conta de emissor da Carteira do Google. O ID do emissor está disponível no Console do Google Pay e da Carteira.
Um emissor pode representar um comerciante (como um restaurante), um provedor de ofertas ou um fabricante de terminais, entre outros. Quando classes e objetos de cartão são desenvolvidos, eles são vinculados a um ID de emissor específico. O ID do emissor está incluído nos IDs de classe de cartão e de objeto.
| ID | Formato | Observações |
|---|---|---|
| Código da classe | issuerId.classSuffix
|
O classSuffix é um valor exclusivo definido pelo desenvolvedor para uma classe de cartão específica (por exemplo, um nível de fidelidade). |
| ID do objeto | issuerId.objectSuffix
|
O objectSuffix é um valor exclusivo definido pelo desenvolvedor para um objeto de cartão específico (como um ID do usuário). |
Um emissor pode criar quantas classes forem necessárias.
ID do coletor
Se um comerciante aceitar o toque inteligente nos terminais, o emissor de resgate terá um ID do coletor. Esse ID é um código numérico (oito dígitos) que os terminais usam para se identificar. Como um emissor de resgate pode aceitar vários comerciantes, o ID do coletor é usado para solicitar o cartão de um comerciante específico.
Quando um usuário toca o dispositivo em um terminal compatível com o Toque inteligente, o terminal envia o ID do coletor para o dispositivo do usuário. Em seguida, o dispositivo é autenticado com o terminal usando a chave pública do ID do coletor. Consulte Fluxo de comunicação para saber mais.
Observações importantes:
- Somente um ID de coletor é atribuído a um ID de emissor.
- O ID do coletor é exclusivo em todos os IDs de emissor.
Para receber um ID de coletor para seu ID de emissor, confira Configuração do comerciante.
ID da classe do cartão
Um ID de classe identifica um nível ou tipo específico de cartão. Um ID de classe tem o formato abaixo:
issuerId.classSuffix
O sufixo da classe é um valor definido pelo desenvolvedor e exclusivo dessa classe de cartão. Um objeto de cartão que se refere a esse ID de classe é salvo no app Carteira do Google do usuário.