Entender os 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 cartões 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 cartão 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 cartões, usamos três códigos para facilitar a coleção de cartões. Isso permite que um comerciante que usa um determinado fornecedor de terminal resgate cartões de muitos desenvolvedores de cartões.

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

  • Código do emissor de resgate
  • Código do coletor
  • Código da classe do cartão

Código do emissor

Código do emissor é o identificador exclusivo de uma conta da API Google Pay for Passes. Você encontra a conta do emissor no Business Console.

Uma conta do emissor pode representar um comerciante, como um restaurante, um provedor de ofertas ou um fabricante de terminais. Quando classes e objetos de cartões são desenvolvidos, eles estão contidos no código do emissor. Um código do emissor pode ter tantos códigos de classe quantos forem necessários.

Uma conta do emissor pode ter no máximo um código do coletor. Para atribuir o código do emissor ao 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 do resgate geralmente representa um único comerciante. Por outro lado, um código do emissor para um desenvolvedor do cartão 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 cartões específicos. Consulte Entender como um terminal solicita cartões 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 cartão

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