Identificadores de coleção

Nesta página, descrevemos os identificadores usados em uma coleção de smart taps.

Visão geral

Smart tap é o protocolo usado entre o aplicativo de terminal e o app Google Pay para transmitir Passes específicos para o terminal.

Veja um resumo do fluxo de comunicação entre o terminal e o app Google Pay:

fluxo de comunicação

O Google armazena códigos usados para facilitar o que enviar, mas o desenvolvedor do Pass define o que é mapeado. Também há uma configuração obrigatória no terminal para reconhecer o que está mapeado.

Como um comerciante pode usar várias empresas ou prestadores de serviços para desenvolver os Passes, usamos três códigos para facilitar a coleção de Passes. Isso permite que um comerciante que usa um determinado fornecedor de terminal resgate Passes de muitos desenvolvedores do Pass.

Há três códigos envolvidos para configurar coleções de terminais de Passes corretos por meio do smart tap:

  • Código do emissor de resgate
  • Código do coletor
  • Código da classe do Pass

Código do emissor

Código do emissor é o identificador exclusivo de uma conta da API Google Pay for Passes Merchant Center.

Uma conta do emissor pode representar um comerciante, como um restaurante, um provedor de ofertas ou um fabricante de terminais. Quando desenvolvidos, classes e objetos do Pass estão contidos no código do emissor. Um código do emissor pode ter quantos códigos de classe conforme necessário.

Uma conta do emissor pode ter no máximo um código do coletor. Para atribuir o código do emissor ao código do coletor ou para criar um novo código do emissor, consulte Ativar o smart tap para um comerciante.

Código do emissor de resgate

Um código do emissor de resgate é um tipo específico de código do emissor. Um código do emissor de resgate normalmente representa um único comerciante. Por outro lado, um código do emissor para um desenvolvedor do Pass pode representar a plataforma, que armazena muitas classes de muitos comerciantes.

Um emissor de resgate terá um código do coletor se o comerciante aceitar o smart tap nos terminais. É assim que os terminais solicitam Passes específicos. Consulte Como um terminal solicita Passes para saber mais.

Código do coletor

Código do coletor é o código numérico usado pelo terminal para se identificar. Normalmente são oito dígitos. Na prática, o código do coletor define o comerciante, e todos os terminais na loja de cada comerciante têm o mesmo código do coletor.

Quando um smart tap ocorre, o terminal envia um código do coletor para o dispositivo móvel. Em seguida, o dispositivo móvel tenta autenticar o terminal com chaves públicas relacionadas ao código do coletor.

Somente um código do coletor é atribuído a um código do emissor, e o código do coletor é exclusivo em todos os códigos do emissor. Para atribuir um código do coletor a um código do emissor, consulte Ativar o smart tap para um comerciante.

Código da classe do Pass

Um código da classe do Pass identifica um nível, ou um tipo, específico de Pass. Por exemplo, “Cartão de fidelidade membro Gold para Baconrista”. Um objeto dessa classe é salvo e mostrado no app Google Pay. Objeto é um Pass específico destinado a um usuário específico. Consulte Classes e objetos para saber mais detalhes.