Quer finalizar compras com mais facilidade no Google Pay? Configure suas opções de pagamento!

8 DE OUTUBRO DE 2024
James O’Reilly Developer Relations Lead
Este conteúdo foi atualizado em 9 de abril de 2025


A integração do Google Pay a apps ou sites é uma ótima maneira de facilitar e agilizar a finalização de compras para seus clientes. Você também pode modificar os métodos de pagamento oferecidos pelo Google Pay na finalização da compra.

Esta postagem traz orientações sobre como configurar os métodos de pagamento aceitos para a integração com o Google Pay. Exploramos a gama de opções, além de redes e tipos de cartões e métodos de autenticação. Você pode aprender a selecionar a melhor configuração para atender a seus requisitos de negócios e maximizar a segurança para você e seus clientes.


Entenda as opções

Você pode configurar a API do Google Pay para permitir que apenas determinados tipos de cartões sejam aceitos ao com a definição de CardParameters. Você deve configurar o seguinte:

Métodos de autenticação: selecione como autenticar cartões a partir do seguinte:

  1. PAN_ONLY: refere-se a cartões salvos na Conta do Google do usuário.
  2. CRYPTOGRAM_3DS: aplica-se a cartões tokenizados e adicionados por meio do app Carteira do Google no Android. Fornece segurança avançada com um criptograma seguro 3D gerado pelo dispositivo para autenticação.


Redes de cartões
: escolha as redes de cartões que você pode aceitar. AMEX, DISCOVER, INTERAC, JCB , MASTERCARD e VISA são as redes aceitas.

Observação para o Brasil: Para oferecer suporte a cartões combinados de débito ou crédito tokenizados, countryCode em TransactionInfo deve ser BR e especificar as duas redes, de crédito e débito, na solicitação.


As seguintes redes são aceitas:

  • VISA
  • ELECTRON
  • MASTERCARD
  • MAESTRO
  • ELO
  • ELO_DEBIT


Tipos de cartões (opcional)
: você pode optar por permitir ou não cartões pré-pagos e cartões de crédito.


Detalhes de garantia (opcional)
: você pode optar por solicitar informações sobre a validação dos dados de pagamento retornados. Como prática recomendada, você deve solicitar detalhes de garantia para diferenciar números de conta FPAN (Funding Primary Account Number) e DPAN (Device Primary Account Number). DPAN é uma versão tokenizada de FPAN, usada em pagamentos por dispositivos móveis ou carteiras digitais para ajudar a evitar fraudes e exposição de números de cartão de crédito.


Faça as melhores escolhas conforme seus requisitos

Métodos de autenticação: PAN_ONLY é a opção mais amplamente suportada, mas CRYPTOGRAM_3DS fornece segurança superior e pode se qualificar para mudança de responsabilidade com certas redes de cartões. É altamente recomendável ativar ambos os métodos de autenticação. Certifique-se de verificar as opções de autenticação com seu processador para saber quais delas têm suporte.

Importante: assegure-se de que seus atuais controles e verificações de risco para transações de pagamento também sejam aplicados às transações FPAN do Google Pay identificadas com detalhes de garantia. A validação do Google Pay e as verificações de fraude não se destinam a substituir seus processos de gerenciamento de riscos. Para obter mais informações, consulte Quando incrementar suas transações do Google Pay como um PSP.


Redes de cartões
: suas escolhas dependem dos recursos de seu processador de pagamentos. Confirme se você oferece suporte às redes que se alinham à sua configuração de processamento.

Tipos de cartões: se você tiver requisitos de negócios específicos para excluir cartões de crédito ou pré-pagos, use as respectivas opções para controlar sua aceitação.

Detalhes de garantia: se você quiser detalhes de garantia, poderá obter informações sobre a verificação de contas e a autenticação de titulares de cartões. Se ambos forem verdadeiros, você não precisará incrementar as credenciais retornadas.

  • Conta verificada: verdadeiro, se a posse pelo titular do cartão for realizada.
  • Titular do cartão autenticado: verdadeiro, se a identificação e verificação (ID&V) forem realizadas.
Importante: se ambos não forem verdadeiros, recomendamos executar as mesmas verificações de risco e de autenticação, além do fluxo seguro 3D, se aplicável.

Endereço de cobrança: os campos de endereço de cobrança que você deseja retornar na resposta dependem dos seus requisitos de negócios. No entanto, para reduzir o atrito para os usuários e gerar mais conversões (vendas incrementais), recomendamos solicitar apenas o que for necessário.


Implementação

Segue o exemplo para a configuração de CardParameters. Você pode usar valores que atendam a seus requisitos de negócios.

{
  "allowedPaymentMethods": [
    {
      "type": "CARD",
      "parameters": {
        "allowedCardNetworks": ["VISA", "MASTERCARD", "AMEX"],
        "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
        "allowPrepaidCards": true,
        "allowCreditCards": true,
        "assuranceDetailsRequired": true,
      }
    }
  ]
}
Observação: esse é um exemplo simplificado. Consulte a documentação da API do Google Pay para obter os detalhes de implementação específicos da plataforma escolhida (Android ou Web).


Ativar filtragem por código de país do emissor

Ressalva: você deve priorizar a expansão da cobertura de países com seus adquirentes antes de usar a filtragem por país do emissor. Esse recurso é uma última alternativa para bloquear países específicos nos quais a aquisição de cobertura não está disponível.

Duas novas propriedades opcionais, allowedIssuerCountryCodes e blockedIssuerCountryCodes, foram adicionadas ao objeto CardParameters. As duas propriedades aceitam uma lista de strings que contém códigos de país ISO 3166-1 com dois caracteres alfanuméricos.

Essas propriedades são aplicáveis em PaymentDataRequest e IsReadyToPayRequest e criam APIs de botão no Android e na Web.

As duas propriedades são mutuamente exclusivas, portanto, apenas uma pode ser definida por vez. Se nenhuma das propriedades for especificada, os usuários do Google Pay poderão selecionar métodos válidos de pagamento por cartão com emissão por operadoras de qualquer região.

Os usuários do Google Pay estão restritos a selecionar métodos de pagamento por cartão para cartões emitidos por operadoras sediadas em uma das regiões especificadas pela lista de permissões allowedIssuerCountryCodes ou não sediadas em uma das regiões especificadas pela lista de bloqueio blockedIssuerCountryCodes. Se um cartão não for emitido nos países permitidos, ele ficará esmaecido, com uma mensagem similar a Não aceito aqui na planilha de pagamentos do Google Pay.

Segue um exemplo de configuração de allowedPaymentMethods com a nova propriedade blockedIssuerCountryCodes especificada.

{
  "allowedPaymentMethods": [
    {
      "type": "CARD",
      "parameters": {
        "allowedCardNetworks": ["VISA", "MASTERCARD", "AMEX"],
        "allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"],
        "blockedIssuerCountryCodes": ["US", "CA"],
        "allowPrepaidCards": true,
        "allowCreditCards": true,
        "assuranceDetailsRequired": true,
      }
    }
  ]
}

Conclusão

Você pode otimizar a integração ao Google Pay para fins de segurança, conveniência e requisitos de negócios com a configuração cuidadosa dos métodos de pagamento aceitos.

Para obter mais ajuda com sua implementação, faça login no console do Google Pay e da Carteira do Google para criar um tíquete de suporte. Você também pode participar da comunidade de desenvolvedores no canal #payments no Discord.


Este artigo foi escrito com a ajuda da IA no Gemini.