Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
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 é um serviço que permite fazer compras facilmente em apps e sites. Com a API Google Pay, seus
clientes podem usar os próprios cartões salvos nas Contas do Google deles para efetuar
pagamentos.
A API Google Pay pode retornar cartões ou tokens de rede.
Faturamento recorrente e assinaturas
A compatibilidade com o faturamento recorrente depende da forma de pagamento retornada na resposta da API Google Pay. Tanto os cartões tokenizados quanto os cartões cadastrados podem ser usados para cobrança 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 próprias APIs de gateway de pagamento para gerenciar o faturamento recorrente.
O Google Pay é compatível com pagamentos recorrentes se as seguintes afirmações forem verdadeiras:
Os comerciantes obedecem às regras de rede, como transações iniciadas pelo comerciante.
Os termos de pagamento são divulgados e aceitos pelo usuário no fluxo de compra do comerciante.
É possível efetuar o faturamento recorrente de valores variáveis, como, por exemplo, contas de telefone mensais de operadoras de celular. Para mais informações, entre 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 todas as
vezes. a credencial de pagamento é armazenada no servidor dele 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
Organizações sem fins lucrativos (ONGs) aprovadas podem integrar a API Google Pay para coletar doações apenas se fornecerem documentação para comprovar, certificar e validar o status de organização sem fins lucrativos. Por exemplo, ONGs dos EUA precisam fornecer uma comprovação de status 501(c)3 válida do IRS para se qualificarem.
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.
Nossa política sobre jogos de azar pode mudar periodicamente. Todos os envios estão sujeitos 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
Futuramente, poderemos expandir o suporte para além do nível atual.
Para ter 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 ao
processo de verificação
da plataforma. Em seguida, 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 fornecer 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, primeiro,
fazer a integração com o
processo de verificação
do Google Play. Em seguida, podemos 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 são qualificados.
Não é permitido usar apps que não redirecionam para um site.
Sim
Chipre
Sim, com restrições:
A loteria estadual é permitida.
A OPAP Cyprus Limited está qualificada.
Cassinos on-line são proibidos.
Máquinas caça-níqueis são proibidas.
As apostas em corridas de cavalos são proibidas.
É proibido apostar em corridas de cães.
As apostas de spread são proibidas.
As bolsas de apostas são proibidas.
Sim, com restrições:
A loteria estadual é permitida.
A OPAP Cyprus Limited está qualificada.
Cassinos on-line são proibidos.
Máquinas caça-níqueis são proibidas.
As apostas em corridas de cavalos são proibidas.
É proibido apostar em corridas de cães.
As apostas de 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:
Loterias estão qualificadas.
As apostas esportivas são permitidas.
Os totalizadores são permitidos.
Cassinos on-line são proibidos.
Os cassinos eletrônicos são proibidos.
Sim, com restrições:
Loterias estão qualificadas.
As apostas esportivas são permitidas.
Os totalizadores são permitidos.
Cassinos on-line são proibidos.
Os 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 destinados a menores de idade ou
proibidos de acordo com as leis locais.
Esteja preparado para compartilhar uma licença relevante ao fazer a integração para validar seu caso de uso de saúde. Todos os envios estão sujeitos 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 consigo 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. Você precisa fornecer uma lista de domínios totalmente qualificados com
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 é 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, poderá informar na descrição da Google Play Store que agora
aceita o Google Pay. Para integrações com a Web, o comerciante pode adicionar uma descrição diretamente no site dele.
As plataformas de comércio eletrônico são compatíveis com o Google Pay?
Sim, a API Google Pay é compatível com a integração de plataformas de e-commerce. Os parceiros de processadores de pagamentos, gateways ou plataformas de e-commerce que hospedam uma página de finalização da compra em nome dos comerciantes podem usar o recurso de finalização da 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?
Qual é a diferença entre o Faturamento do Google Play no app 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 Visão geral do Google Play Faturamento para saber mais sobre o faturamento no aplicativo.
Quando usada em aplicativos, 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 próprio 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 formando 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?
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?
Como recebo o dinheiro das compras feitas com o Google Pay?
A API Google Pay facilita as transações ao transmitir as 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 sobre 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ê reenviar. Em caso de dúvidas sobre o 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 soluçõ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, é possível
escolher quais redes de cartão e países emissores de cartão você quer permitir.
O que é a API Google Pay?
Com a API Google Pay, seus clientes podem pagar com o toque 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.
Qual é a relação entre a API Google Pay e a API Google Wallet?
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.
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 são compatíveis com 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 computadores e os dispositivos iOS não são compatíveis com DPANs e, por padrão, retornam
PAN_ONLY.
Como diferenciar um DPAN de um FPAN e como eles devem ser tratados?
Em vez de identificar estritamente DPANs versus 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). 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 transferência de responsabilidade?
Como identificar transações de Compre Agora, Pague Depois (BNPL)?
No momento, não há um identificador específico para transações de BNPL. Eles vão aparecer no seu sistema
como credenciais de FPAN normais.
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 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 após exatamente 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 ocorre, o 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:
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 o pagamento?
Não. O cookie NID não é usado nem é compatível com o processo de finalização da compra da API Google Pay.
O cookie NID está associado a um serviço do Google do lado do servidor, projetado para armazenar dados personalizados de usuários que não estão conectados a 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.
[null,null,["Última atualização 2026-11-05 UTC."],[],["The Google Pay API allows customers to use saved cards for in-app and website checkouts. Merchants can receive support through the Google Pay & Wallet Console and utilize troubleshooting guides. The API supports recurring billing and auto-reloads without repetitive API calls, managing these through payment gateway APIs. Google Pay does not charge additional fees, but merchants still have processing costs. Merchants need to follow specific policies and provide documentation to collect donations or use services like gambling, healthcare and financial services.\n"]]
