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 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 salvos podem ser usados para o faturamento recorrente. O comerciante não precisa chamar a API sempre que processar essa forma de pagamento, já que a credencial é armazenada no servidor dele. 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
O comerciante não precisa chamar nossa API todas as vezes que processar uma cobrança de recarga automática de mesmo custo, já que a credencial de pagamento é armazenada no servidor dele e reutilizada. Para mais informações, entre em contato com o representante do gateway de pagamento.
Estornos
Os comerciantes podem efetuar a reversão de transações relacionadas a cancelamentos, reembolsos ou disputas da mesma forma como lidam com estornos em outras formas de pagamento. Para mais informações, entre em contato com o representante dos processadores.
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 da API Google Pay
Todos os comerciantes precisam concordar e aderir aos Termos de Serviço 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
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, podemos 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 atender a 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, siga a política de jogos de azar do Google Play e passe pelo processo de avaliação do Google Play primeiro. 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 fornecer serviços de jogos de azar no país durante
o processo de integração com a API Google Pay. Depois, podemos avaliar sua integração somente na 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, primeiro siga a política de jogos de azar do Google Play e o processo de análise do Google Play. Em seguida, podemos avaliar suas integrações para Android e 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 a integração com a Web
Bulgária
Sim, com restrições:
Os apps que redirecionam para um site estão qualificados.
É proibido usar apps que não redirecionam para um site.
Sim
Chipre
Sim, com restrições:
A loteria estadual está qualificada.
A OPAP Cyprus Limited está qualificada.
Os cassinos on-line são proibidos.
Os caça-níqueis são proibidos.
Apostas em corridas de cavalos são proibidas.
Apostas em corridas de cachorros são proibidas.
As apostas no spread são proibidas.
As bolsas de apostas são proibidas.
Sim, com restrições:
A loteria estadual está qualificada.
A OPAP Cyprus Limited está qualificada.
Os cassinos on-line são proibidos.
Os caça-níqueis são proibidos.
Apostas em corridas de cavalos são proibidas.
Apostas em corridas de cachorros são proibidas.
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 se qualificam.
Os totalizadores estão qualificados.
Os 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 se qualificam.
Os totalizadores estão qualificados.
Os 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 estão qualificadas.
Sim, com restrições:
As apostas esportivas on-line são qualificadas.
Se você expandir a API Google Pay para um país em que não tinha aprovação, entre em contato para receber a aprovação da expansão.
É 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 jogar 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. Todas as
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.
Compartilhe uma licença relevante ao integrar para validar seu caso de uso de serviços financeiros. Todas as inscrições estão sujeitas 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ê pode receber um ID de 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, usar um único ID de comerciante em várias marcas e plataformas (como Web e Android)
é compatível e geralmente recomendado para simplificar a conciliação.
Como os comerciantes podem divulgar que aceitam o Google Pay nos apps e sites deles?
Para informar os usuários que eles podem efetuar pagamentos com o Google Pay, use os recursos disponíveis nas diretrizes da promoção de marca
Android e
Web.
Se você tiver integração com o Android, informe na descrição da Play Store que aceita o Google Pay. 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 pode ser integrada a plataformas de comércio eletrônico. Processadores de pagamentos, gateways ou parceiros de plataforma de e-commerce que hospedam páginas de pagamento em nome dos comerciantes podem usar o recurso do Google Pay de finalização de compra hospedado.
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 para Android precisam usar o
Faturamento do Google Play no app, conforme especificado na
Central de políticas do desenvolvedor do Google Play. Exemplos de Faturamento em apps incluem produtos de jogos virtuais, recursos ou conteúdo de apps e produtos de software na nuvem. Consulte a página Visão geral do Google Play Faturamento para saber mais sobre o faturamento no aplicativo.
Quando usada em apps, a API Google Pay está disponível apenas para produtos e serviços físicos.
O Google Pay cobra alguma taxa?
O Google Pay não cobra taxas extras de usuários, comerciantes e desenvolvedores para usar a
API Google Pay. Os comerciantes especificamente continuam pagando taxas de processamento ao processador do pagamento.
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 dados do cartão, o que
inclui o código de segurança do cartão (CVC). O Google também executa um mecanismo de risco reservado baseado em dados de faturamento, perfis de Contas do Google, histórico de compras, local 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, nas 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 da implementação, consulte a documentação sobre Como usar o WebView do Android ou Como usar o WKWebView do iOS.
Meu processador não está na lista. 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 pagamento.
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 provedor de plataforma de pagamentos ou um processador de pagamentos?
Como faço para oferecer o Google Pay em grande escala aos meus comerciantes se eu for um processador de pagamentos de suporte?
Os processadores de pagamentos compatíveis podem implementar nossa solução de finalização de compra hospedada para integrações da Web.
Com a finalização de compra hospedada, seus clientes podem oferecer o Google Pay aos consumidores e pular a integração individual com o Google Pay.
Para começar, faça a integração como um processador de pagamentos compatível. Para integrar a solução de finalização da compra hospedada, entre em contato com seu ponto de contato técnico do Google, que ajudou você na integração.
Como o Google Pay pode acomodar diferentes opções e preços de frete para meus usuários se eu oferecer frete no fluxo de finalização de compra?
Como faço para receber o dinheiro das compras feitas com o Google Pay?
A API Google Pay facilita as transações transmitindo 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 ter acesso à produção?
Os comerciantes precisam criar um Perfil da Empresa no console do Google Pay e da Carteira e enviar 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 da minha inscrição de 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 vai mostrar o status Ativo no Console do Google Pay e da Carteira. Se forem necessárias mudanças, o status vai mostrar Precisa de mais informações, e o e-mail vai fornecer detalhes sobre o que precisa ser corrigido antes de você enviar de novo. 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 na minha integração da API Google Pay se aparecer uma mensagem de erro?
Para códigos de 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 da API Google Pay para restringir cartões?
Todas as personalizações para 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 simples 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 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.
A API Google Wallet permite que os desenvolvedores criem e gerenciem cartões digitais para vários casos de
uso. Por exemplo, cartões de fidelidade, ingressos, cartões de acesso, registros 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 processadas?
A versão atual está listada na documentação Android e
da Web. O Google manteve essa versão por 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 só estão disponíveis ao fazer pagamentos 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 com o 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 do 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 é original 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
um dispositivo Android e usou um token de rede provisionado com base em dispositivo.
Como usamos essas flags para acionar o 3D Secure?
Os comerciantes precisam 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 compatíveis com a SCA, e não será necessário aumentar a transação para mais autenticação 3DS.
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?
A disponibilidade da transferência de responsabilidade depende da rede do cartão. A MasterCard oferece esse recurso automaticamente para transações qualificadas com token, enquanto a Visa exige que os comerciantes ativem manualmente pelo Console do Google Pay. Consulte Ativar a transferência de responsabilidade da Visa para mais detalhes.
Como podemos identificar transações de "Compre agora, pague depois" (BNPL, na sigla em inglês)?
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 precisa usar
o pacote de cartões de teste no ambiente de sandbox para atender às suas necessidades de teste.
Qual é a expiração 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 com o provedor de serviços de pagamento (PSP) dentro desse período antes que o payload expire.
Como são processadas as operações pós-compra, como reembolsos e novas autorizações?
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 proprietário (como um "Token do comerciante" ou "ID do perfil do cliente"). Todas as interações e movimentações financeiras após a compra são gerenciadas
inteiramente entre você e seu PSP.
[null,null,["Última atualização 2026-02-27 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"]]