Solução de problemas

O guia de solução de problemas do Android aborda questões e problemas relacionados aos seguintes tópicos.

O app está sendo executado em um ambiente de teste.

O usuário pode ver a seguinte mensagem ao escolher um cartão de pagamento na caixa de diálogo de detalhes do pagamento:

O app está sendo executado em um ambiente de teste. As transações não resultam em uma cobrança real

Esse erro indica que o app usa ENVIRONMENT_TEST e não recebe credenciais de pagamento reais, mas recebe informações pessoais, incluindo endereço de faturamento, número de telefone do endereço de faturamento, endereço de entrega e endereço de e-mail, se solicitado.

Falha na solicitação

A mensagem de erro mais comum é OR_BIBED_06. Essa mensagem de erro também aparece na IU como uma caixa de diálogo com o seguinte texto:

Falha na solicitação
Há um problema com a integração do Google Pay do comerciante. Entre em contato com o comerciante para receber ajuda ou pague com outra forma.

Para saber mais sobre esse erro, siga estas etapas:

  1. Verifique se o Android Debug Bridge (adb) está instalado no computador.
  2. Certifique-se de que a depuração de USB esteja ativada no seu dispositivo. Para mais informações, consulte Depurar seu app.
  3. Conecte o dispositivo Android ao computador ou inicie o simulador.

  4. Execute o comando a seguir em um terminal ou prompt de comando no seu computador:

    adb logcat -s WalletMerchantError

A resposta indica o motivo do erro. Por exemplo, você pode ver:

02-26 17:41:28.133 14593 14593 W WalletMerchantError: Error in loadPaymentData: This
merchant profile does not have access to this feature.

A ação que você precisa tomar para resolver o problema depende da mensagem de erro.

Validade do gateway

Você pode encontrar os seguintes erros relacionados à validade do gateway em algum momento da sua integração. A lista a seguir oferece algumas dicas úteis de solução de problemas caso esses erros apareçam.

OR_BIBED_06 Gateway desconhecido 'yourgateway'
O valor da propriedade gateway especificado em tokenizationSpecification não é compatível com a API Google Pay no momento. Entre em contato com seu gateway para mais informações sobre o identificador e os campos associados, como gatewayMerchantId.
OR_BIBED_06 O gateway "example" não pode ser usado no modo de produção.
O valor da propriedade do gateway de exemplo é usado apenas para fins de teste e não pode ser usado com um valor de parâmetro de ambiente WalletOptions definido como WalletConstants.ENVIRONMENT_PRODUCTION. Entre em contato com seu gateway para mais informações sobre os parâmetros gateway que você precisa usar com a API Google Pay.

Registro e acesso

Você pode encontrar os seguintes erros relacionados ao registro e acesso em algum momento da sua integração. A lista a seguir oferece algumas dicas úteis de solução de problemas caso esses erros apareçam.

OR_BIBED_07 Essa API exige a biblioteca do Google Play Services versão 8.4 ou mais recente
Verifique se o Google Play Services está atualizado no dispositivo que executa o app.
OR_BIBED_07 Nenhuma chave encontrada para este perfil de comerciante
Você precisa registrar sua chave de criptografia pública no Google usando o Console do Google Pay e da Carteira para concluir uma integração do DIRECT tokenizationSpecification type.
OR_BIBED_07 Este perfil de comerciante não tem acesso a esse recurso.
Você não concluiu o processo de registro do app na API Google Pay. Consulte Solicitar acesso de produção para mais informações.
OR_BIBED_10 Este comerciante está em uma região onde o Google Pay não é aceito.
O serviço do Google Pay não está disponível na região. Consulte a lista de países onde o serviço está disponível para mais informações
OR_BIBED_11 O comerciante não concluiu o registro para usar a API Google Pay. Acesse o console (https://pay.google.com/business/console) para verificar.
Você não concluiu o processo de registro do app na API Google Pay. Consulte Solicitar acesso de produção para mais informações.
OR_BIBED_12 Esta integração da API Google Pay está desativada. Entre em contato para mais informações (https://developers.google.com/pay/api/faq#how-to-get-support).
Entre em contato para saber mais sobre as etapas necessárias para reativar a API Google Pay na sua conta.
OR_BIBED_13 As impressões digitais da chave de assinatura {11:22:33:44:55:66:77:88:99:AA:BB:CC:DD:EE:FF:11:22:33:44:55} não correspondem aos nossos registros para este app.
A API Google Pay só pode ser usada no modo de produção se o APK estiver assinado com a chave de assinatura correta. Para mais informações, consulte Assinar o app.

Comerciantes diretos

Talvez você encontre os seguintes erros relacionados ao comerciante direto em algum momento da sua integração. A lista a seguir oferece algumas dicas úteis de solução de problemas caso esses erros apareçam.

Verificação de assinatura
Talvez você encontre um erro de verificação de assinatura se o merchantId estiver errado. Isso pode acontecer no ambiente TEST quando você usa a biblioteca Tink paymentmethodtoken. Para evitar esse problema, defina YOUR_MERCHANT_ID como em:
.recipientId("merchant:YOUR_MERCHANT_ID")
Falha ao descriptografar o token
Se você usa a biblioteca paymentmethodtoken do Tink para descriptografar um token, siga estas etapas:
  • Garanta que o ambiente de resposta da API Google Pay corresponda ao ambiente do Tink. Por exemplo, se a resposta da API Google Pay retornar por meio do ENVIRONMENT_TEST, o Tink indicará o ambiente de teste para a descriptografia.
  • Não modifique a resposta da API Google Pay antes de transmiti-la ao Tink. Certifique-se de enviar o token completo retornado por meio da resposta da API Google Pay. Para mais detalhes, veja a observação abaixo:
  • Certifique-se de que você tem a chave privada adequada associada à chave pública registrada no Google.
Geração de um par de chaves pública e privada no Windows
Se você usa o Windows e quer seguir as etapas mencionadas na seção Como usar o OpenSSL para gerar um par de chaves privada e pública, instale o Cygwin na sua máquina. Essa ação é necessária para executar os comandos do Linux.

Android WebView

OR_BIBED_15 O Google Pay não foi carregado corretamente porque este app usa uma WebView. Os desenvolvedores precisam seguir as instruções para ativar o Google Pay no Android WebView.
Siga as instruções para ativar a API Google Pay para Android WebView.

CardInfo

O que é o recurso CardInfo?
O Google Pay indica aos consumidores que há um cartão associado ao botão de pagamento do Google Pay, que renderiza a rede da marca e os últimos quatro dígitos do cartão.
Por que o recurso CardInfo não é renderizado na minha implementação?

Para que o recurso CardInfo funcione, precisamos das seguintes condições: