Google Pay
Receba pagamentos pelo Google Pay.
O Google Pay permite fazer pagamentos no seu aplicativo ou site com qualquer cartão de crédito ou débito salvo na conta do Google, inclusive no Google Play, YouTube, Chrome ou aparelho Android. Use a API Google Pay para solicitar cartões de crédito ou débito armazenados na conta do seu cliente.
O Google Pay é totalmente compatível com os produtos e recursos da Stripe (por exemplo, pagamentos recorrentes), permitindo que você o utilize no lugar de uma forma de pagamento tradicional sempre que for possível. Use-o para aceitar pagamentos referentes a produtos físicos, doações, assinaturas e assim por diante.
Uso da Stripe e Google Pay x sistema de faturamento do Google Play
Para vendas de mercadorias e serviços físicos, seu aplicativo pode aceitar Google Pay ou qualquer forma de pagamento aceita pela Stripe. Esses pagamentos são processados pela Stripe, e você só precisa pagar as tarifas de processamento da Stripe. No entanto, compras de produtos e conteúdos digitais no aplicativo devem usar o sistema de faturamento do Google Play. Esses pagamentos são processados pelo Google e estão sujeitos às tarifas de transação do Google.
Para obter mais informações sobre quais compras devem usar o sistema de faturamento do Google Play, consulte os termos para desenvolvedores do Google Play.
Aceitar um pagamento usando Google Pay em um aplicativo Android
O GooglePayLauncher
, parte do SDK para Android da Stripe, é a forma mais rápida e fácil de começar a aceitar o Google Pay em aplicativos Android.
Pré-requisitos
Para aceitar o Google Pay no Android, você precisa do seguinte:
- Uma
minSdkVersion
de19
ou superior. - Uma
compileSdkVersion
de28
ou superior.
Além disso, se quiser testar com seu próprio dispositivo, você precisa adicionar uma forma de pagamento à sua Conta do Google.
Configurar a integração
Para usar o Google Pay, habilite a API Google Pay adicionando o seguinte à <application>
tag do seu AndroidManifest.xml:
<application> ... <meta-data android:name="com.google.android.gms.wallet.api.enabled" android:value="true" /> </application>
Este guia considera que você está usando a versão mais recente do SDK para Android da Stripe.
Veja mais detalhes na Configuração da API Google Pay do Google Pay para Android.
Adicionar o botão do Google Pay
Adicione o botão do Google Pay ao seu aplicativo seguindo o tutorial do Google. Isso garante o uso dos ativos corretos.
Instanciar o GooglePayLauncher
Em seguida, crie uma instância de GooglePayLauncher em Activity
ou Fragment
. Isso pode ser feito em Activity#onCreate()
.
GooglePayLauncher.
expõe propriedades obrigatórias e opcionais que configuram GooglePayLauncher
. Consulte GooglePayLauncher.
para ver mais detalhes sobre as opções de configuração.
Depois de instanciar GooglePayLauncher
, a instância de GooglePayLauncher.
é chamada com um sinalizador que indica se o Google Play está disponível e pronto para uso. Esse sinalizador pode ser usado para atualizar a IU, indicando ao cliente que o Google Pay está pronto para uso.
Lançar o GooglePayLauncher
Depois de o Google Pay estar disponível e o aplicativo obter um segredo do cliente de PaymentIntent
ou SetupIntent
, lance GooglePayLauncher
usando o método adequado. Para confirmar um PaymentIntent
, use GooglePayLauncher#presentForPaymentIntent(clientSecret)
. Para confirmar um SetupIntent
, use GooglePayLauncher#presentForSetupIntent(clientSecret)
.
Gerenciar o resultado
Por fim, implemente GooglePayLauncher.
para gerenciar o resultado da operação GooglePayLauncher
.
O resultado pode ser GooglePayLauncher.
, GooglePayLauncher.
ou GooglePayLauncher.
.
Usar o Google Pay no modo de produção
Siga as instruções do Google para solicitar acesso de produção para seu aplicativo. Escolha o tipo de integração Gateway quando solicitado e forneça capturas de tela do seu aplicativo para análise.
Após a aprovação do aplicativo, teste sua integração em produção definindo o ambiente como GooglePayEnvironment.
e iniciando o Google Pay em uma versão assinada do seu aplicativo. Lembre-se de usar suas chaves de API do modo de produção. Você pode usar um PaymentIntent
com capture_
= manual
para processar uma transação sem capturar o pagamento.
Criar um PaymentMethod
Se você confirmar o pagamento no servidor, poderá usar GooglePayPaymentMethodLauncher
para somente coletar um PaymentMethod
, em vez de confirmar o pagamento.
Contestações
Os usuários precisam autenticar os pagamentos com as contas do Google Pay, o que reduz o risco de fraude ou pagamentos não reconhecidos. No entanto, os usuários ainda podem contestar transações após finalizarem o pagamento. Você pode enviar comprovantes para refutar diretamente uma contestação. O processo de contestação é o mesmo dos pagamentos com cartão. Saiba como gerenciar contestações.
Transferência de responsabilidade para cobranças do Google Pay
O Google Pay aceita transferência de responsabilidade no mundo todo. Isso ocorre automaticamente para os usuários em produtos hospedados pela Stripe e que usam o Stripe.js. Para transações da Visa fora de um produto hospedado pela Stripe, você deve habilitar a transferência de responsabilidade no console do Google Pay e Google Wallet. Para fazer isso, acesse o Console do Google Pay e Google Wallet, selecione API do Google Pay na barra de navegação à esquerda e ative a Proteção de responsabilidade por fraude para tokens de dispositivo Visa para proteção de transferência de responsabilidade.
Há três casos de uso de transações do Google Pay:
- Se o usuário adicionar um cartão ao aplicativo Google Pay usando o dispositivo móvel, esse cartão é salvo como Número de Conta Principal de Dispositivo (DPAN) e aceita transferência de responsabilidade automaticmente.
- Se o usuário adicionar um cartão ao Chrome ou a uma propriedade do Google (por exemplo, YouTube ou Google Play), esse cartão será salvo como um Número de Conta Principal de Financiamento (FPAN). A transferência de responsabilidade é aceita nas principais bandeiras do mundo, incluindo a Visa, quando o 3D Secure é executado. Você pode personalizar as regras do Stripe Radar para solicitar a ativação do 3D Secure.
- Se o usuário selecionar o Google Pay como forma de pagamento em um site de e-commerce ou em um aplicativo que paga com Google Pay, os cartões são salvos como tokens de e-commerce que representam os cartões registrados. A transferência de responsabilidade e o 3D Secure não são aceitos para tokens de e-commerce no momento.
Para usuários do Sigma, a tabela de charges
contém um campo card_
que indica o tipo de transação do Google Pay. Uma transação FPAN define o card_
como fpan
. Transações de token DPAN e e-commerce definem o card_
como dpan_
.
Reembolsos
Você pode reembolsar de forma parcial ou total qualquer pagamento bem-sucedido do Google Pay. O processo de reembolso é o mesmo dos pagamentos com cartão. Consulte Reembolsar e cancelar pagamentos para obter instruções sobre como iniciar ou gerenciar reembolsos.