API Google Pay for Passes

Com a plataforma Google Pay API for Passes, sua empresa pode exibir cartões de fidelidade, vales-presente, ofertas, ingressos para eventos, cartões de embarque para voos e bilhetes de transporte para milhões de usuários do Android.

Com a API, é possível criar um link ou botão que permite aos usuários salvar cartões de fidelidade, vales-presente, ofertas, ingressos para eventos, cartões de embarque para voos e cartões de transporte público no app Google Pay. Esses itens salvos são armazenados como objetos.

Com o uso de notificações, atualizações e mensagens baseadas em localização, é possível usar a API para envolver os clientes com seus cartões e gerenciá-los de forma conveniente no aplicativo Google Pay.

Processo típico de inclusão de recursos

O gráfico a seguir apresenta um processo típico de inclusão de recursos com a API Google Pay for Passes.

Etapa 1: descoberta técnica
Etapa 2: integração técnica Etapa 3: validação e controle de qualidade Etapa 4: fase de lançamento
Etapa 5: após lançamento

As seguintes atividades fazem parte de cada etapa de uma inclusão de recursos bem-sucedida:

Descoberta técnica
1. Analisar a documentação dos desenvolvedores
2. Criar uma conta de serviço
3. Desenvolver a inclusão do recurso
Integração técnica
1. Desenvolver a inclusão do recurso
2. Preparar o recurso a ser exibido
Validação e controle de qualidade
1. Realizar testes de controle de qualidade
2. Revisar o design da experiência do usuário (apenas para cartões de embarque e ingressos de eventos)
Fase de lançamento
1. Começar a lançar em diferentes áreas
2. Iniciar o teste em massa
Lançado
1. Exibir em várias áreas

Estratégias de integração recomendadas

A API Google Pay for Passes aceita as indústrias de cartões indicadas nas tabelas a seguir. Revise a tabela e escolha a estratégia de integração recomendada pelo tipo de cartão e de integração.

	Programas de fidelidade	Ofertas	Vales-presente	Ingressos para eventos (ET)	Cartões de embarque (BP) para voos	Cartões de transporte público (TP)	Cartões agrupados (apenas BP, ET e TP)
Navegador da Web	Botão da Web JavaScript (JS)	Botão da Web JS	Botão da Web JS	Botão da Web JS	Botão da Web JS	Botão da Web JS	Botão da Web JS
SMS ou e-mail	Link JSON Web Token (JWT)	Link JWT	Link JWT	Link JWT "skinny"	Link JWT "skinny"	Link JWT "skinny"	Link JWT "skinny"
Aplicativo nativo	Link JWT	Link JWT	Link JWT	Link JWT "skinny" método de solicitação POST JWT	Link JWT "skinny" método de solicitação POST JWT	Link JWT "skinny" método de solicitação POST JWT	Link JWT "skinny" método de solicitação POST JWT
WebView	Link JWT	Link JWT	Link JWT	Link JWT	Link JWT "skinny"	Link JWT "skinny"	Link JWT "skinny"

Cuidado: se possível, evite usar um WebView com a integração de cartões. Em vez disso, solicite ao usuário que salve o cartão a partir do app nativo. Se um WebView for usado, implemente o método shouldOverrideUrlLoading, que permite redirecionamentos para pay.google.com. Essa implementação é semelhante ao seguinte snippet de código:

@Override
      public boolean shouldOverrideUrlLoading(WebView view, WebResourceRequest request) {
        if(request.getUrl().getHost().startsWith("pay.google.com")) {
          Intent intent = new Intent(Intent.ACTION_VIEW, request.getUrl());
          view.getContext().startActivity(intent);
          return true;
        }
        ...
        ...
      }

Para entender o que está disponível com sua estratégia de integração, leia as seguintes informações sobre cartões e sobre o Google Pay.

Salvar no Google Pay

Todos os cartões são compatíveis com a gravação no Google Pay com o uso de um botão da Web do JavaScript, por e-mail ou SMS, e com um aplicativo Android com um link e um intent do JWT. Além disso, há diferenças na compatibilidade do recurso "Salvar do app Android usando o SDK nativo", conforme mostrado na tabela a seguir:

	Programas de fidelidade	Ofertas	Vales-presente	Ingressos dos eventos	Cartões de embarque para voos	Bilhetes de transporte público
Salvar do app Android usando o SDK nativo

Para mais informações, leia sobre os detalhes de implementação sobre como salvar cartões no Google Pay.

Resgatar do Google Pay

Todos os cartões são compatíveis com o resgate do tipo "exibir e escanear", bem como o resgate por toque NFC. Leia sobre os detalhes de implementação sobre como resgatar cartões do Google Pay.

Interagir pelo Google Pay

Todos os cartões são compatíveis com uma seção de informações comerciais, seções personalizadas de texto e imagem, mensagens personalizadas e status de resgate, que determina se um usuário removeu o cartão e a localização. A tabela a seguir indica os recursos e as notificações compatíveis de formas específicas por diferentes tipos de cartões:

	Programas de fidelidade	Ofertas	Vales-presente	Ingressos dos eventos	Cartões de embarque para voos	Bilhetes de transporte público
Recursos
Modelos
Ofertas vinculadas
Consulta do Assistente
Notificações
Notificações acionadas por fronteira geográfica virtual
Notificação da expiração
Selecionar as notificações de atualização de campo
Notificação de evento, voo ou viagem iminente

Para mais informações, leia sobre os detalhes de implementação sobre como engajar usuários por meio do Google Pay.

Para ver como cada recurso é mostrado no app Google Pay, consulte as páginas de modelo de cartão para fidelidade, vales-presente, ofertas, ingressos de evento, cartão de embarque e passagens de transporte público.