Google Pay™

Entendendo os conceitos

🚧

Importante!

As funcionalidades apresentadas abaixo estão disponíveis tanto para cliente PSP quanto para clientes Gateway integrados via V5.

Os clientes Gateway devem estar integrados em uma das adquirentes compatíveis. São elas: Stone, Rede, Getnet e Cielo 3.0.

O Google Pay é a maneira rápida e simples de pagar com o Google em qualquer lugar.

Com o Google Pay, compradores podem fazer pagamentos no seu site ou aplicativo com cartões de crédito armazenados em suas contas do Google. Tudo isso de forma prática e segura, com uma experiência mais simples de Checkout.

Como Funciona

Quando o seu cliente paga com Google Pay, a ele é exibida uma página com as formas de pagamento salvas na Conta do Google, além de campos opcionais, como endereço de entrega. Os usuários podem selecionar rapidamente uma forma de pagamento, adicionar um endereço de entrega opcional ou inserir novas informações.

O fluxo de pagamento ocorre da seguinte maneira:

• O usuário clica no botão de finalização da compra do Google Pay, e é exibida uma página com uma lista de formas de pagamento compatíveis.
• O usuário seleciona uma opção, e o Google Pay retorna ao seu site um token seguro referente à forma de pagamento escolhida.
• Seu site envia o token junto com os detalhes da compra para o back-end.
• Para concluir a transação, o back-end processa a compra e envia o token ao provedor de serviços de pagamento.

O Lojista pode configurar os campos obrigatórios que o cliente deverá preencher no ato do pagamento. Como por exemplo o Endereço de Cobrança.

Primeiros passos

Implementação

Web

Caso o seu tipo de integração seja para aplicativo Web, encontrará todos os insumos na Documentação do desenvolvedor!

Ao final da integração em seu aplicativo Web, use a lista de verificação de integração para garantir que você concluiu todas as etapas necessárias na sua integração com o dispositivo Web.

Além de ser necessário seguir as diretrizes da promoção de marca do Google Pay para Web.

Android

Caso o seu tipo de integração seja para aplicativo Android, encontrará todos os insumos na Documentação do desenvolvedor!

Ao final da integração em seu aplicativo Android, use a lista de verificação de integração para garantir que você concluiu todas as etapas necessárias na sua integração com o dispositivo Android.

Além de ser necessário seguir as diretrizes da promoção de marca do Google Pay para Android.

📘

ID do Comerciante

Você receberá seu ID de comerciante do Google Pay depois que a integração for validada pelo Google. Consulte a Lista de verificação de integração para mais detalhes.

Definição do Gateway

Na etapa de definição do Gateway, a qual você configurará a tokenização de pagamento, a Pagar.me utiliza o tipo de tokenização PAYMENT_GATEWAY que é a implementação de comerciante mais comum da forma de pagamento com cartão na API Google Pay.

Sendo assim, os parâmetros são:

“gateway” como “pagarme”

“type” como “PAYMENT_GATEWAY”

Conforme o exemplo:

const tokenizationSpecification = {
  type: 'PAYMENT_GATEWAY',
  parameters: {
    'gateway': 'pagarme',
    'gatewayMerchantId': 'account_id'
  }
};

🚧

Definições de Bandeiras, PAN ONLY e 3DS

Ficam a cargo da sua integração, além da disponibilidade do seu credenciador. Se seu credenciador for a Pagar.me ou a Stone, as bandeiras compatíveis são Visa e Mastercard e os ambos os métodos de autenticação ("PAN_ONLY", "CRYPTOGRAM_3DS") são suportados.

Bandeiras

Exemplo contendo os parâmetros "Mastercard" e "Visa":

{"allowedCardNetworks": ["MASTERCARD", "VISA"]}

Autenticação

Exemplo contendo os parâmetros "PAN_ONLY" e "CRYPTOGRAM_3DS":

{"allowedAuthMethods": ["PAN_ONLY", "CRYPTOGRAM_3DS"]}

Definição do ambiente de teste

A definição do ambiente é importante, pois definirá a estrutura do token gerado pela API Google Pay. E também influenciará no momento da descriptografia que a Pagar.me executará.

Para configurar o ambiente, basta definir a variável citada abaixo:

Utilize o valor:

const paymentsClient =
    new google.payments.api.PaymentsClient({environment: 'TEST'});

Definição dos dados de compra no objeto BillingAddressParameters

Para criar um objeto PaymentDataRequest recomendamos que utilize:

“currencyCode” o valor “BRL”.

O campo “merchantName” é o nome que o comprador visualizará durante o pagamento com Google Pay, sendo assim, recomenda-se colocar um nome amigável e reconhecido.

Definição dos dados de endereço de cobrança no objeto PaymentDataRequest

Esse objeto permite que você solicite os dados de endereço de cobrança. Consulte BillingAddressParameters para mais informações sobre a necessidade do endereço de faturamento para processamento.

Testar e implantar

Ao final das configurações, o envio do token para a API do lojista já poderá ser testado.

Checklist e solicitação de credenciais de produção

Recomendamos que utilize a Lista de verificação de integração do Google para facilitar na construção da integração. Ao validar que todos os pontos foram atendidos solicite os dados de acesso produtivos.