Perguntas frequentes

Esta página contém informações gerais e perguntas frequentes sobre a API Google Pay.

Sobre a API Google Pay

O Google Pay permite finalizações de compras sem esforço para seu app e site. Com a API Google Pay, seus clientes podem usar os próprios cartões salvos nas Contas do Google deles para efetuar pagamentos.

Como receber suporte

Registre-se no Console do Google Pay e da Carteira e selecione "Entrar em contato com o suporte". Podemos ajudar a resolver problemas com suas integrações. Além disso, consulte nossos guias Solução de problemas do Android e Solução de problemas da Web para depurar sua integração por conta própria.

Recursos compatíveis

A API Google Pay tem vários recursos compatíveis.

Formas de pagamento aceitas

A API Google Pay pode retornar cartões ou tokens de rede.

Faturamento recorrente e assinaturas

O suporte para faturamento recorrente está vinculado à forma de pagamento retornada na resposta da API Google Pay. Tanto os cartões tokenizados quanto os registrados podem ser usados para faturamento recorrente. Para processar o faturamento recorrente, o comerciante não precisa chamar nossa API em uma cadência. Em vez disso, a credencial de pagamento é armazenada no lado do comerciante para pagamentos recorrentes. O comerciante usa as APIs do gateway de pagamento para gerenciar o faturamento recorrente.

O Google Pay aceita pagamentos recorrentes se as seguintes afirmações forem verdadeiras:

  • Os comerciantes obedecem às regras da rede, como transações iniciadas por eles.
  • Os termos de pagamento são divulgados e aceitos pelo usuário no fluxo de compra do comerciante.

Também oferecemos suporte a faturamento recorrente com valores variáveis. Por exemplo, contas de telefone mensais de operadoras de celular são aceitas. Para mais informações, os comerciantes precisam entrar em contato com o representante do gateway de pagamento.

Recarga automática

Para processar uma cobrança de recarga automática pelo mesmo custo, o comerciante não precisa chamar nossa API a cada vez. A credencial de pagamento é armazenada no lado do comerciante e reutilizada. Para mais informações, os comerciantes precisam entrar em contato com o representante do gateway de pagamento.

Estornos

Os comerciantes podem lidar com reversões de transações para cancelamentos, reembolsos ou disputas da mesma forma que lidam com estornos para outras formas de pagamento. Para mais informações, os comerciantes precisam entrar em contato com o representante do processador.

Coleta de doações

As organizações sem fins lucrativos (OSFLs) aprovadas podem integrar a API Google Pay para receber doações, desde que forneçam documentação para comprovar, certificar e validar o status de organização sem fins lucrativos. Por exemplo, as ONPs dos EUA precisam fornecer um comprovante válido de status 501(c)3 do IRS para se qualificar.

Termos e Políticas

Termos de Serviço do Google Pay

Todos os comerciantes precisam concordar e seguir os Termos de Serviço do Google Pay.

Política de Uso Aceitável da API Google Pay

Todos os comerciantes precisam concordar e obedecer à Política de Uso aceitável da API Google Pay.

Política de jogos de azar

Nossa política sobre jogos de azar é definida na Política de Uso Aceitável da API Google Pay.

Nossa política sobre jogos de azar pode mudar periodicamente. Todas as inscrições estão sujeitas a análise e aprovação.

Aceitamos integrações de jogos de azar de empresas com sede nos seguintes países:

  • Austrália
  • Áustria
  • Canadá
  • República Tcheca
  • França
  • Geórgia
  • Alemanha
  • Grécia
  • Hungria
  • Irlanda
  • Itália
  • Japão
  • Países Baixos
  • Polônia
  • Portugal
  • Romênia
  • Espanha
  • Suécia
  • Reino Unido

Em uma etapa posterior, poderemos expandir o suporte para além do nível atual.

Para receber acesso de produção à API Google Pay para integrações de jogos de azar, é necessário concluir uma série de pré-requisitos:

  • Se você tiver uma integração de jogos de azar somente para Android em um dos países mencionados anteriormente, será necessário aderir à política de jogos de azar do Google Play e, primeiro, fazer a integração com o processo de verificação do Google Play. Depois, podemos avaliar sua integração somente para Android para acesso de produção à API Google Pay.
  • Se você tiver uma integração de jogos de azar somente na Web em um dos países mencionados anteriormente, envie uma licença autorizada para comprovar sua qualificação para oferecer serviços de jogos de azar no país durante o processo de integração com a API Google Pay. Em seguida, podemos avaliar sua integração somente para Web para acesso de produção à API Google Pay.
  • Se você tiver uma integração de jogos de azar para Android e Web em um dos países mencionados anteriormente, será necessário aderir à política de jogos de azar do Google Play e fazer a integração com o processo de verificação do Google Play primeiro. Em seguida, vamos avaliar suas integrações do Android e da Web para acesso de produção à API Google Pay.

Países com condições ou restrições específicas

As integrações de jogos de azar são permitidas nos países listados se atenderem aos seguintes critérios:

País Qualificação para integração com o Android Qualificação para integração com a Web
Bulgária Sim, com restrições:
  • Os apps que redirecionam para um site estão qualificados.
  • Não é permitido usar apps que não redirecionam para um site.
 Sim
Chipre Sim, com restrições:
  • A loteria estadual é qualificada.
  • A OPAP Cyprus Limited está qualificada.
  • Cassinos on-line são proibidos.
  • Os caça-níqueis são proibidos.
  • Apostas em corridas de cavalos são proibidas.
  • É proibido apostar em corridas de cães.
  • As apostas no spread são proibidas.
  • As bolsas de apostas são proibidas.
 Sim, com restrições:
  • A loteria estadual é qualificada.
  • A OPAP Cyprus Limited está qualificada.
  • Cassinos on-line são proibidos.
  • Os caça-níqueis são proibidos.
  • Apostas em corridas de cavalos são proibidas.
  • É proibido apostar em corridas de cães.
  • As apostas no spread são proibidas.
  • As bolsas de apostas são proibidas.
Finlândia Sim, com restrições:
  • A Veikkaus Oy está qualificada.
 Sim, com restrições:
  • A Veikkaus Oy está qualificada.
Cazaquistão Sim, com restrições:
  • As loterias estão qualificadas.
  • As apostas esportivas estão qualificadas.
  • Os totalizadores são permitidos.
  • Cassinos on-line são proibidos.
  • Os cassinos eletrônicos são proibidos.
 Sim, com restrições:
  • As loterias estão qualificadas.
  • As apostas esportivas estão qualificadas.
  • Os totalizadores são permitidos.
  • Cassinos on-line são proibidos.
  • Cassinos eletrônicos são proibidos.
Polônia Não Sim, com restrições:
  • Provedores de jogos de azar licenciados são qualificados.
África do Sul Sim, com restrições:
  • As apostas esportivas on-line são permitidas.
 Sim, com restrições:
  • As apostas esportivas on-line são permitidas.

Se você expandir a API Google Pay para um país em que ainda não tem aprovação, entre em contato conosco para receber a aprovação. Será necessário fornecer uma licença de jogos de azar autorizada para cada país em que você planeja oferecer serviços relacionados a jogos de azar. Não permitimos que a API Google Pay seja usada para serviços de jogos de azar direcionados a menores de idade ou proibidos de acordo com as leis locais.

Política de saúde

Nossa política sobre saúde é definida na Política de Uso Aceitável da API Google Pay.

Esteja preparado para compartilhar uma licença relevante ao fazer a integração para validar seu caso de uso de saúde. Todas as inscrições estão sujeitas a análise e aprovação.

Política de serviços financeiros

Nossa política sobre serviços financeiros está definida na Política de Uso Aceitável da API Google Pay.

Esteja preparado para compartilhar uma licença relevante ao fazer a integração para validar seu caso de uso de serviços financeiros. Todos os envios estão sujeitos a análise e aprovação.

Perguntas frequentes gerais

As perguntas frequentes a seguir se aplicam aos comerciantes:

Eu uso um PSP grande para gerenciar todos os riscos e a Autenticação Segura do Cliente. O que preciso saber sobre o GPay?

A API Google Pay retorna as formas de pagamento em um payload assinado e criptografado. As formas de pagamento retornadas consistem em cartões PAN ou tokenizados feitos de PAN de dispositivos (DPAN) e criptogramas.

Os payloads de cartões tokenizados são processados sem outras etapas ou desafios.

Os payloads do cartão que consistem em PAN exigem o 3D Secure por meio de uma solução interna ou fornecida por PSP.

Se o PSP gerenciar todo o risco e a lógica de SCA, verifique se a integração da API Google Pay inclui as seguintes propriedades:

  • merchantInfo.merchantName (Android, Web): o nome do comerciante é renderizado na página de pagamento.
  • transactionInfo.countryCode (Android, Web): indica onde a transação é processada. É preciso especificar o país do banco do adquirente.
  • transactionInfo.totalPrice (Android, Web): o valor monetário total da transação com uma precisão decimal opcional de duas casas decimais.
Como faço para receber um ID do comerciante do Google?
Você vai receber um ID do comerciante do Google depois que o Google aprovar seu site. Para iniciar o processo, faça login no Console do Google Pay e da Carteira e crie uma integração da API Google Pay. É necessário fornecer uma lista de domínios totalmente qualificados, incluindo subdomínios, que ajudam a chamar a API Google Pay.
Podemos usar um único ID do comerciante em várias marcas e canais (Web/App)?
Sim, é possível usar um único ID do comerciante em várias marcas e plataformas (como Web e Android). Isso é geralmente recomendado para simplificar a reconciliação.
Como os comerciantes podem divulgar que aceitam o Google Pay nos apps e sites deles?
Para destacar o suporte ao Google Pay, use os recursos disponíveis nas nossas Android para Android e Web.
Se você tiver uma integração com o Android, informe na descrição da Google Play Store que agora o Google Pay é aceito. Para integrações com a Web, o comerciante pode adicionar uma descrição diretamente no site dele.
As plataformas de e-commerce são compatíveis com o Google Pay?
Sim, a API Google Pay oferece suporte à integração de plataformas de e-commerce. Os parceiros de processadores de pagamento, gateways ou plataformas de e-commerce que hospedam uma página de finalização de compra em nome dos comerciantes podem usar o recurso de finalização de compra hospedada do Google Pay.
Quais provedores de pagamento aceitam o Google Pay?
Para ver uma lista dos processadores compatíveis com o Google Pay, consulte a página Processadores do Google Pay.
Quais países e regiões são compatíveis com o Google Pay?
Consulte nossa lista de países compatíveis que usam o Google Pay para pagamentos on-line ou em apps.
Quais países e regiões são compatíveis com tokens (CRYPTOGRAM_3DS) do Google Pay?
Consulte a página Encontrar formas de pagamento aceitas nas compras em lojas e por aproximação para ver uma lista de países e os bancos de cada um deles que aceitam tokens (CRYPTOGRAM_3DS) do Google Pay. Ela mostra os cartões compatíveis e os não compatíveis.
Qual é a diferença entre o Faturamento no app do Google Play e a API Google Pay?
Os desenvolvedores do Google Play que vendem produtos e softwares digitais em apps Android precisam usar o Faturamento do Google Play no app, conforme especificado na Central de políticas para desenvolvedores do Google Play. Exemplos de Faturamento no app incluem produtos de jogos virtuais, recursos ou conteúdo de apps e produtos de software em nuvem. Consulte a página de visão geral do Google Play Faturamento para saber mais sobre o faturamento no app.
Quando usada em apps, a API Google Pay está disponível apenas para serviços e produtos físicos.
O Google Pay cobra alguma taxa?
O Google Pay não cobra taxas adicionais de usuários, comerciantes e desenvolvedores para usar a API Google Pay para pagamentos. Os comerciantes, especificamente, continuam pagando taxas de processamento ao processador de pagamentos.
O que o Google faz para validar credenciais e evitar fraudes?
Todos os cartões adicionados ao Google passam por uma autorização de verificação para validar os detalhes do cartão, que incluem o código de segurança do cartão (CVC). O Google também executa um mecanismo de risco proprietário com base em dados de instrumentos, perfis da Conta do Google, histórico de compras, locais e informações do dispositivo. No entanto, os comerciantes ainda precisam usar as próprias ferramentas de avaliação de fraude e risco com as transações do Google Pay.
O Google Pay é compatível com WebViews de apps para dispositivos móveis?
As WebViews do Android são totalmente compatíveis com o Google Pay e imitam a experiência da Web para dispositivos móveis, desde que você adicione a dependência necessária do WebKit. No entanto, em WebViews do iOS, a API isReadyToPay sempre vai retornar false devido às restrições do iOS em cookies de terceiros. O app Android e o domínio do site no WebView precisam ser aprovados para acesso de produção. Para detalhes específicos de implementação, consulte a documentação Como usar o WebView do Android ou Como usar o WKWebview do iOS.
Meu processador não está listado. Ainda posso fazer a integração com o Google Pay?
O Google Pay está sempre criando parcerias com plataformas de e-commerce e processadores de pagamentos. Se você não encontrar seu processador em g.co/pay/processors, envie uma solicitação. Você vai receber uma notificação quando o processador estiver disponível.
Como faço para ativar o Google Pay se já tenho um processador de pagamentos ou um provedor de plataforma de pagamentos?
O Google Pay funciona com vários provedores de serviços de pagamento e plataformas de e-commerce. Cada um oferece documentação específica e personalizada para ajudar você a começar, além do nosso tutorial principal para facilitar a integração.
Como faço para oferecer o Google Pay em grande escala aos meus comerciantes, se sou um processador de pagamentos compatível?
Os processadores de pagamentos compatíveis podem implementar nossa solução de finalização da compra hospedada para integrações da Web. Com a finalização de compra hospedada, seus clientes podem oferecer o Google Pay aos clientes deles e pular a integração individual com o Google Pay.

Para começar, você precisa fazer a integração como um processador de pagamentos aceito. Para integrar a solução de finalização da compra hospedada, entre em contato com o ponto de contato técnico do Google que ajudou você na integração.

Como o Google Pay pode acomodar diferentes opções de frete e preços para meus usuários se eu oferecer frete no meu processo de finalização da compra?
Para integrações da Web, você precisa de um endereço de entrega e exibir diferentes opções de envio e preços nos objetos PaymentDataRequest, PaymentOptions e PaymentDataCallbacks. Para um exemplo, consulte a demonstração de Atualização de preço dinâmica.

Para integrações do Android, é necessário um endereço de entrega no objeto PaymentDataRequest.

Como recebo o dinheiro das compras feitas com o Google Pay?
A API Google Pay facilita as transações ao transmitir informações de pagamento dos usuários para seu provedor de serviços de pagamento. Ele não está no fluxo de dinheiro e foi projetado para ficar acima da sua infraestrutura de pagamento atual.
Quais são os requisitos para acessar a produção?
Os comerciantes precisam criar um Perfil da Empresa no console do Google Pay e da Carteira e fazer upload de capturas de tela do fluxo de compra para análise. Cada domínio que hospeda a API Google Pay precisa ser enviado para aprovação individualmente, já que domínios curinga (por exemplo, *.merchant.com) não são aceitos. Consulte a página "Publicar sua integração" para Android e/ou Web para mais informações.
Como posso saber o status do envio da minha integração e se preciso fazer alguma mudança após o processo de revisão?
Depois de enviar sua integração da API Google Pay para análise, você vai receber um e-mail com os resultados. Se a integração seguir nossa Política de Uso Aceitável e as diretrizes da marca, ela será aprovada e o status será mostrado como Ativo no Console do Google Pay e da Carteira. Se precisar de mudanças, o status vai mostrar Precisa de mais informações, e o e-mail vai detalhar o que precisa ser corrigido antes de você enviar de novo. Em caso de dúvidas sobre seu envio, entre em contato com o suporte diretamente no Console do Google Pay e da Carteira.
Como posso resolver problemas com minha integração da API Google Pay se eu receber uma mensagem de erro?
Para códigos do erro e resoluções comuns, consulte nossos guias de solução de problemas para Android e Web. Se tiver outras dúvidas, entre em contato com o suporte pelo Console do Google Pay e da Carteira.
Como posso personalizar minha integração com a API Google Pay para restringir cartões?
Todas as personalizações de cards estão disponíveis no objeto CardParameters para Android e Web. Por exemplo, você pode escolher quais redes e países emissores de cartão quer permitir.
O que é a API Google Pay?
Com a API Google Pay, seus clientes podem pagar com o clique de um botão usando as formas de pagamento salvas na Conta do Google. A API oferece uma finalização de compra simples para milhões de usuários com centenas de milhões de cartões salvos. Ele oferece mais segurança, com os dados de pagamento do cliente criptografados de ponta a ponta dos servidores do Google para o processador de pagamentos. É um processo de integração fácil que funciona com sua pilha de processamento de pagamentos atual e pode ser implementado com algumas linhas de código.
Como a API Google Pay e a API Google Wallet estão relacionadas?
A API Google Pay e a API Google Wallet são duas APIs separadas. Com a API Google Pay, seus clientes podem usar o Google Pay como forma de pagamento no seu site ou app Android. Com a API Google Wallet, os desenvolvedores podem criar e gerenciar cartões digitais para vários casos de uso. Por exemplo, cartões fidelidade, ingressos, cartões de acesso, históricos de saúde e outros itens personalizáveis. Para saber mais sobre a API Google Wallet, acesse a documentação para desenvolvedores da API Google Wallet.

Qual é a versão atual da API Google Pay e como as atualizações são gerenciadas?
A versão atual está listada na documentação do Android e da Web. O Google mantém essa versão há vários anos, adicionando apenas novos recursos e campos opcionais. Todas as atualizações feitas na API são compatíveis com versões anteriores para garantir que as integrações atuais não sejam interrompidas.
Quais plataformas aceitam DPANs (CRYPTOGRAM_3DS) e FPANs (PAN_ONLY)?
Os DPANs são específicos do Android e estão disponíveis apenas ao finalizar a compra em dispositivos Android ou na Web para dispositivos móveis/WebViews do Android. A Web para computador e os dispositivos iOS não oferecem suporte a DPANs e vão retornar PAN_ONLY por padrão.
Como diferenciar um DPAN de um FPAN e como eles devem ser tratados?
Em vez de identificar estritamente DPANs e FPANs, o objeto assuranceDetails foi projetado para ajudar os comerciantes a determinar se uma transação precisa ser intensificada pelo 3D Secure para atender aos requisitos de Autenticação Segura do Cliente (SCA, na sigla em inglês). Para receber esses detalhes, os comerciantes precisam adicionar assuranceDetailsRequired: true ao parâmetro de cartão na solicitação da API Google Pay.
Qual é a diferença entre cardHolderAuthenticated e accountVerified?
Quando assuranceDetailsRequired é definido como true na solicitação, a resposta inclui duas propriedades:
  • accountVerified: indica que o cartão usado para pagar é genuíno e que a conta está em situação regular. No entanto, essa verificação por si só não oferece proteção de autorização.
  • cardHolderAuthenticated: indica que o usuário iniciou a transação com o dispositivo Android e usou um token de rede provisionado com base no dispositivo.
Como usamos essas flags para acionar o 3D Secure?
Os comerciantes devem usar essas flags para criar a lógica de acionamento do 3D Secure. Se cardHolderAuthenticated e accountVerified retornarem como true, as credenciais serão consideradas altamente seguras e em conformidade com a SCA, e você não precisará intensificar a transação para uma autenticação 3DS adicional.
Os comerciantes vão receber tokens de e-commerce se definirem assuranceDetailsRequired: true?
Não, os tokens de e-commerce são controlados no nível do PSP.
As transações do Google Pay estão qualificadas para a transferência de responsabilidade?
A disponibilidade da transferência de responsabilidade depende da rede do cartão. Consulte Ativar a transferência de responsabilidade da Visa para mais detalhes.
Como identificar transações de Compre Agora, Pague Depois (BNPL)?
No momento, não há um identificador específico para transações de BNPL. Elas vão aparecer no seu sistema como credenciais normais de FPAN.
O Google pode fornecer cartões de teste para testar cenários de SCA?
A API Google Pay não pode fornecer cartões de teste de SCA diretamente. Seu PSP deve ser capaz de usar o pacote de cartões de teste no ambiente de sandbox para atender às suas necessidades de teste.
Qual é a validade ou o time to live (TTL) da credencial de pagamento criptografada?
O payload criptografado do Google Pay expira exatamente após uma semana. Os comerciantes que lidam com autorizações atrasadas ou processamento assíncrono precisam garantir que o pagamento seja autorizado pelo provedor de serviços de pagamento (PSP) dentro desse período, antes que o payload expire.
Como as operações pós-compra, como reembolsos e reautorizações, são processadas?
O Google Pay não participa do fluxo de dinheiro e atua estritamente como um intermediário para a credencial tokenizada. Depois que a transação inicial é realizada, seu provedor de serviços de pagamento (PSP) mapeia as informações de pagamento no payload criptografado para o próprio token (como um "Token do comerciante" ou "ID do perfil do cliente"). Todas as interações pós-compra e movimentações de dinheiro são gerenciadas inteiramente entre você e seu PSP.
Como a determinação dinâmica de preços funciona com as transações iniciadas pelo comerciante?
No momento, as transações iniciadas pelo comerciante (MITs, na sigla em inglês) não são compatíveis com a determinação dinâmica de preços. Essa é uma limitação conhecida.
Qual configuração da Política de Segurança de Conteúdo (CSP) é necessária para o Google Pay em uma WebView?

Se você estiver usando uma Política de Segurança de Conteúdo (CSP), defina os valores corretos para a diretiva connect-src para permitir que o Google Pay seja usado na sua WebView. Exemplo:

Content-Security-Policy: connect-src pay.google.com google.com account.google.com www.google.com
Como usar um nonce da Política de Segurança de Conteúdo (CSP) com a API Google Pay para Web?

Se o site aplicar uma CSP rigorosa que exige nonces para a execução de scripts e estilos injetados dinamicamente:

  1. Inclua o atributo nonce da CSP na tag <script> que carrega pay.js:

    <script
  async
  src="https://pay.google.com/gp/p/js/pay.js"
  nonce="your-nonce-value"
  onload="onGooglePayLoaded()">
</script>

  2. Transmita a propriedade nonce em PaymentOptions ao instanciar PaymentsClient:

    const paymentsClient = new google.payments.api.PaymentsClient({
  environment: 'TEST',
  nonce: 'your-nonce-value'
});

O Google Pay aplica esse atributo nonce a todos os elementos <style> e <script> injetados dinamicamente, incluindo estilos de botão criados por createButton().

A API Google Pay usa ou exige o cookie NID durante a finalização da compra?

Não. O cookie NID não é usado nem oferece suporte ao processo de finalização da compra da API Google Pay.

O cookie NID está associado a um serviço do lado do servidor do Google projetado para armazenar dados personalizados de usuários que não fizeram login em uma Conta do Google.

As funções essenciais do serviço, incluindo segurança, prevenção contra fraudes e confiabilidade do serviço, operam de forma independente do cookie NID. A API Google Pay foi projetada para manter uma experiência segura e confiável para comerciantes e usuários, independentemente da presença desse cookie.

O Google tem o compromisso de proteger a privacidade e garante que esses cookies sejam tratados de acordo com a Política de Privacidade e a Política de Tecnologias e Cookies do Google. Esses recursos podem ser úteis para sua documentação de compliance e para oferecer mais transparência aos usuários.