Lista de verificação de integração

Use a lista de verificação a seguir para garantir que você concluiu todas as etapas necessárias na sua integração na Web.

Sobre o ambiente de teste

Uma configuração de teste da API Google Pay não retorna informações de pagamentos ativos e sujeitos à cobrança. Ela permite testar elementos do seu fluxo de trabalho de compra. Veja a seguir os elementos testáveis:

  • Páginas de confirmação
  • Recibos
  • Endereço de faturamento (opcional)
  • Número de telefone de faturamento (opcional)
  • Endereço de entrega (opcional)
  • Endereço de e-mail (opcional)

Inicialize um novo PaymentsClient com um objeto JavaScript que contenha uma propriedade de ambiente definida como TEST para usar um ambiente de teste com um exemplo de resposta de dados de pagamento.

Veja a seguir uma amostra de código:
var paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Testar usando o console do desenvolvedor do seu navegador

Teste seu site com a versão mais recente de um navegador compatível. Para fazer isso, abra as ferramentas para desenvolvedores do seu navegador para visualizar as mensagens do console relacionadas ao seu site. As mensagens incluem erros ou avisos da biblioteca de cliente JavaScript da API Google Pay. A API Google Pay é compatível com os navegadores Google Chrome, Mozilla Firefox, Apple Safari, Microsoft Edge, Opera e UCWeb UC.

Outros erros podem ser exibidos na caixa de diálogo de seleção de pagamentos feitos com serviços do Google depois de chamar loadPaymentData(). Ao clicar em Continuar ou OK depois de visualizar a mensagem de erro, isso pode retornar mais detalhes na Promise processada pelo seu site.

Testar em um dispositivo compatível

A API Google Pay está disponível em muitos mercados, mas os cartões tokenizados só estão disponíveis em um subconjunto de países. Se os cartões tokenizados forem definidos como uma forma de pagamento permitida, teste-os em um dispositivo Android com o Chrome para Android versão 59 ou posterior e Google Play Services versão 16.0.0 ou superior. Se a forma de pagamento for permitida no seu país e pelo banco emissor, teste com um cartão armazenado no app Google Pay.

Teste usando a depuração remota do Chrome para computadores para visualizar avisos e erros de console gerados pelo Google Chrome para Android. Para mais informações sobre possíveis erros, veja os registros em seu dispositivo Android. É possível ver os registros de erro usando a janela da ferramenta Logcat no Android Studio, a ferramenta de linha de comando adb logcat ou dentro de um relatório de bugs do Android. Pesquise WalletMerchantError para visualizar as mensagens de erro relacionadas à API Google Pay.

Veja a seguir uma amostra de código:

adb logcat -s WalletMerchantError

Testar sua integração

Antes de enviar sua integração ao Google para validação com um PaymentsClient configurado para o ambiente TEST, verifique se você cumpriu os critérios de saída para cada verificação funcional e de branding abaixo:

1. Noções básicas

Certifique-se de que as verificações e controles de risco para transações com cartão ou PAN também sejam aplicados às transações do Google Pay. As verificações de validação e fraude do Google Pay não têm o intuito de substituir seus processos de gerenciamento de riscos.
Você precisa ler e estar pronto para aceitar nossos Termos de Serviço. O registro na API Google Pay exige que seu endereço de e-mail esteja associado a uma conta do Google e, de preferência, a um e-mail comercial associado ao domínio da sua empresa (por exemplo, admin@meudominiopessoal.com). Selecione Usar meu endereço de e-mail atual durante o fluxo de criação da conta do Google para associar seu e-mail a uma conta do Google.
Use os dados recebidos da API Google Pay apenas para processamento de transações. Todos os outros casos de uso exigem um consentimento expresso separado do usuário.
Confirme as redes e os métodos de autenticação de cartões aceitos pelo processador de pagamentos no seu país.
Se você concluir uma integração do DIRECT tokenizationSpecification type, será necessário fazer a rotação anual da chave de criptografia e fornecer o atestado PCI ao Google usando o Console Business. O atestado PCI pode ser enviado por um assessor de segurança qualificado ou de terceiros certificado pelo Conselho de padrões de segurança do PCI e aceito por um fornecedor aprovado ou um avaliador qualificado.

2. Testes de marca

Use nossos recursos aprovados e siga todos os elementos das nossas diretrizes da marca.
Certifique-se de que o botão de pagamento do Google Pay apareça somente depois que seu site confirmar a capacidade de pagamento do usuário por meio da função isReadyToPay().
Confirme se as dimensões do botão de pagamento do Google Pay exibido correspondem aos botões e elementos semelhantes na página.
Escolha um botão apropriado com base na cor de fundo da área em que ele é exibido.

3. Testes funcionais

Verifique se loadPaymentData() está sendo chamado de forma síncrona ao clicar no botão de pagamento do Google Pay e se mantém o comportamento de ativação do usuário do navegador, permitindo que a API Google Pay mostre uma página de pagamento. Confira se a página de pagamento do Google Pay não está bloqueada por bloqueadores de pop-ups.

Ao solicitar uma forma de pagamento do tipo CARD com autenticação de cartão PAN_ONLY, siga estas etapas para executar o teste de cartões cadastrados:

  1. Se aplicável, remova todos os cartões cadastrados de pay.google.com.
  2. Volte para sua integração.
  3. Clique em Google Pay.
  4. Confira se você vê a opção de adicionar um cartão.
  5. Adicione um cartão de uma rede compatível, conforme definido em parameters.allowedCardNetworks.
  6. Confira se você vê o cartão adicionado com um logotipo de rede no seletor.

O teste a seguir é aplicável apenas para o Chrome no Android.

Ao solicitar uma forma de pagamento do tipo CARD com a autenticação de cartão CRYPTOGRAM_3DS, siga estas etapas para realizar o teste do token do dispositivo Android:

  1. Adicione um cartão qualificado ao aplicativo para Android Google Pay e verifique se o emissor é compatível.
  2. Volte para sua integração.
  3. Clique no botão de pagamento do Google Pay.
  4. Confira se você vê o cartão adicionado com a arte do cartão no seletor.

Se você confirmou que seu processador é compatível com autenticação de cartões 3D-Secure, pode continuar mesmo que um token de dispositivo Android não esteja disponível para você como usuário ou titular de cartão do Android.

Teste o processamento do endereço de entrega, se você precisar de um, em vários estados de conclusão, como os que constam a seguir:

  • Variações de um nome completo a ser analisado em campos estruturados, como "João", "João Silva" e "Jane Silva Pereira".
  • Analise com precisão todas as linhas de endereço retornadas pela API Google Pay, que podem ultrapassar o número total de linhas normalmente coletadas em seu fluxo de pagamento padrão.
  • Verifique se o componente de país retornado do endereço corresponde aos destinos de envio compatíveis do seu site. Se você especificou restrições de envio, teste-as inserindo um endereço de entrega não compatível em nossa página de pagamento e veja se as restrições estão funcionando.

Se você implementou o suporte para Autorizar pagamentos, verifique o seguinte:

  • Em caso de falha na autenticação de pagamento, ela retorna um ERRORtransactionState e PaymentDataError com o intent PAYMENT_AUTHORIZATION.

Se você implementou suporte para Atualizações dinâmicas de preços, siga estas etapas:

  • Adicione um cartão e endereço ao mesmo tempo na página de pagamento. Atualize as opções de envio, a lista de pedidos e o preço total.
  • Adicione e selecione um endereço de entrega. Atualize as opções de envio, a lista de pedidos e o preço total.
  • Selecione uma opção de envio. Atualize a lista de pedidos e preço total.
  • Retorne PaymentDataError com o intent SHIPPING_ADDRESS quando o endereço de entrega não tiver opções de envio disponíveis.
  • Retorne PaymentDataError com o intent SHIPPING_OPTION quando a opção de envio selecionada for inválida.
  • Retorne ERROR transactionState e PaymentDataError com o intent PAYMENT_AUTHORIZATION em caso de falha na autenticação do pagamento.
Se você precisar de um número de telefone, solicite-o no endereço de faturamento. Em seguida, teste se é possível analisar e armazenar o número de telefone nos padrões de dados do seu site usando formatos diferentes, como "+8005550100", "18005550100" e "(800) 555-0100".
Verifique se o Google Pay é exibido em paridade com outras formas de pagamento de terceiros.
Para os usuários que selecionaram o Google Pay no momento da finalização da compra e indicaram o Google Pay como a preferência para pagamento em seu site, o Google Pay precisa ser a forma de pagamento padrão para a próxima compra.
Um preço final precisa ser exibido ao usuário antes do processamento da transação. Se o valor a ser cobrado tiver variado com base nos dados recebidos da API Google Pay, você precisará exibir uma página de confirmação com um preço final.