Usar a API para configurar o smart tap

Nesta página, descreveremos como usar uma API para configurar o smart tap.

Criar uma conta do emissor de resgate para o smart tap

Para criar uma conta do emissor de resgate, execute estas três tarefas:

1. Crie uma conta do emissor.
2. Atribua chaves públicas e versões da chave.
3. Receba o ID do coletor gerado automaticamente.

Criar uma conta do emissor

Para criar contas de emissor com a API, consulte Criar contas de emissor programaticamente.

Para criar uma conta do emissor manualmente, solicite acesso à API Google Pay for Passes.

Atribuir chaves públicas e versões da chave

A chave pública e a versão da chave são fornecidas pelo fornecedor do terminal.

Ponto principal: se o fornecedor do terminal não conceder uma chave pública antes de você fornecer o ID do coletor, use esta chave de demonstração:

-----BEGIN PUBLIC KEY-----\nMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEchyXj86
9zfmKhRi9xP7f2AK07kEo\n4lE7ZlWTN14jh4YBTny+hRGRXcUzevV9zSSPJlPHpqqu5pEwlv1xyFvE1w==
\n-----END PUBLIC KEY-----\n
    

Na primeira vez em que você define uma chave pública, um ID do coletor exclusivo é gerado para a conta do emissor de resgate.

Não se esqueça de remover essa chave de demonstração assim que você receber a chave pública real do fornecedor do terminal.

Para atribuir chaves públicas e versões da chave, use uma chave da conta de serviço autorizada a fim de fazer uma chamada REST para o seguinte endpoint:

PATCH https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

Importante: o smartTapMerchantData.authenticationKeys[].id precisa ser decimal. O intervalo está entre 1 e 2.147.483.647 (incluindo esses valores). Ele está identificado como Versão da chave no Merchant Center da API Google Pay for Passes. Cada chave pública precisa ter uma versão única de chave.

Observação: use uma chave da conta de serviço autorizada vinculada à conta do usuário que criou essa conta do emissor.

Inclua o seguinte no corpo da chamada REST:

{
  "smartTapMerchantData": {
    "authenticationKeys": [{
        "id": 1,
        "publicKeyPem": "<my_public_key>"
      },
      {
        "id": 2,
        "publicKeyPem": "..."
      }
    ]
  }
}

A resposta inclui o corpo enviado e um campo extra, smartTapMerchantData.smartTapMerchantId. Este é o ID do coletor da conta do emissor de resgate. Forneça o ID do coletor e outras informações ao provedor do terminal e ao comerciante para Ativar o smart tap para um comerciante.

Para mais informações sobre como usar o endpoint do emissor, consulte a referência de API.

Receber o ID do coletor gerado automaticamente

Há outra maneira de visualizar o ID do coletor. Use uma chave da conta de serviço autorizada a fim de fazer uma chamada REST para o seguinte endpoint:

GET https://walletobjects.googleapis.com/walletobjects/v1/issuer/<issuerid>

Observação: use uma chave da conta de serviço autorizada vinculada à conta do usuário que criou essa conta do emissor.

A resposta inclui o campo, smartTapMerchantData.smartTapMerchantId. Este é o ID do coletor da conta do emissor de resgate. Forneça o ID do coletor e outras informações ao provedor do terminal e ao comerciante para Ativar o smart tap para um comerciante.

Para mais informações sobre como usar o endpoint do emissor, consulte a referência de API.

Ativar um cartão para resgate do smart tap

Para configurar classes e objetos de modo que os cartões possam ser resgatados com o smart tap, siga as instruções nesta seção.

Se os valores abaixo e a conta do emissor do resgate estiverem configurados corretamente, o cartão mostrará um ícone de comunicação a curta distância (NFC, na sigla em inglês) no Google Pay. Somente os comerciantes que configurarem terminais compatíveis com o smart tap poderão resgatar cartões com o ícone NFC.

Configurar classe

Para configurar uma classe de modo que os objetos sejam compatíveis com NFC, faça uma solicitação de patch e defina estes valores:

  class.enableSmartTap = true
  class.redemptionIssuers[] = ["issuer_id_1",... ,"issuer_id_n"]

Depois que você definir as propriedades da classe acima, todos os objetos nessa classe serão compatíveis com NFC. Para ver um ícone NFC, configure o objeto para o smart tap e os emissores de resgate. Para determinar os emissores de resgate, consulte Determinar a conta do emissor de resgate.

Aviso: se você usar a classe update() na API REST, sempre chame o método get() primeiro para depois fazer a atualização. Do contrário, você pode acabar apagando essas propriedades ou definindo elas incorretamente. Como alternativa, use patch().

Configurar objeto

Para configurar um objeto que seja compatível com NFC, configure a classe para o smart tap. Em seguida, defina o seguinte valor que será transmitido do seu cartão para o terminal:

  object.smartTapRedemptionValue = "string value to be conveyed over NFC"

Esse valor é transmitido ao tocar no NFC. Consulte Valor transmitido pelo cartão para mais detalhes.

Aviso: se você usar a classe update() na API REST, sempre chame o método get() primeiro para depois fazer a atualização. Do contrário, você pode acabar apagando essas propriedades ou definindo elas incorretamente. Como alternativa, use patch().