---
title: "Google Pay™ (legado)"
url: "https://devcenter.stone.com.br/legacy-google-pay"
image: "https://devcenter.stone.com.br/_og/d/c_Ocean.takumi,title_~R29vZ2xlIFBheeKEoiAobGVnYWRvKQ,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiMzMEE2NkQifX19,p_Ii9sZWdhY3ktZ29vZ2xlLXBheSI,s_K7akyJmaBREJr6pm.png"
---

# Google Pay™

Documentação Pagar.me v5 — referência histórica.

Documentação legada do Pagar.me v5

Esta página descreve um conceito da **Pagar.me v5** (versão clássica). Para projetos novos, explore o **[API Catalog](https://devcenter.stone.com.br/catalog)**.

## [Entendendo os conceitos](#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, Cielo e Rede.

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.

![](https://files.readme.io/0246143-docs_google-pay-tm_1-documentacao.png "docs_google-pay-tm_1-documentacao.png")

## [Como Funciona](#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.

![](https://files.readme.io/f15288b-Google_Pay-documentacao.png "Google Pay-documentacao.png")

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](#primeiros-passos)

### [Implementação](#implementação)

#### [Web](#web)

Caso o seu tipo de integração seja para aplicativo **Web**, encontrará todos os insumos na [Documentação do desenvolvedor](https://developers.google.com/pay/api/web/?hl=pt-br)!

Ao final da integração em seu aplicativo **Web**, use a [lista de verificação de integração](https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist?hl=pt-br) 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**](https://developers.google.com/pay/api/web/guides/brand-guidelines?hl=pt-br).

#### [Android](#android)

Caso o seu tipo de integração seja para aplicativo **Android**, encontrará todos os insumos na [Documentação do desenvolvedor](https://developers.google.com/pay/api/android/?hl=pt-br)!

Ao final da integração em seu aplicativo **Android**, use a [lista de verificação de integração](https://developers.google.com/pay/api/android/guides/test-and-deploy/integration-checklist?hl=pt-br) 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**](https://developers.google.com/pay/api/android/guides/brand-guidelines?hl=pt-br).

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](https://developers.google.com/pay/api/android/guides/test-and-deploy/integration-checklist) para mais detalhes.

---

### [Definição do Gateway](#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:

```Text
const tokenizationSpecification = {
  type: 'PAYMENT_GATEWAY',
  parameters: {
    'gateway': 'pagarme',
    'gatewayMerchantId': 'account_id da pagarme' ##Exemplo: acc_8Vj4qPGTaA9PTsl
  }
};
```

---

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](#bandeiras)

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

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

#### [Autenticação](#autenticação)

Exemplo contendo os parâmetros "PAN\_ONLY" e "CRYPTOGRAM\_3DS":

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

### [Definição do ambiente de teste](#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:

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

### [Definição dos dados de compra no objeto BillingAddressParameters](#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](#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](https://developers.google.com/pay/api/web/reference/request-objects#BillingAddressParameters) para mais informações sobre a necessidade do endereço de faturamento para processamento.

## [Testar e implantar](#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](#checklist-e-solicitação-de-credenciais-de-produção)

**Recomendamos que utilize a [Lista de verificação de integração](https://developers.google.com/pay/api/web/guides/test-and-deploy/integration-checklist?hl=pt-br) do Google para facilitar na construção da integração. Ao validar que todos os pontos foram atendidos solicite os dados de acesso produtivos.**

---

**Jornada: [Cobrar um cliente](https://devcenter.stone.com.br/legacy-overview-transacao)**  
Etapa 18 de 22

[**Etapa anterior**SafetyPay](https://devcenter.stone.com.br/legacy-safetypay)[**Próxima etapa**Apple Pay](https://devcenter.stone.com.br/legacy-apple-pay)

Siga a Stone nas redes sociais

[](https://www.facebook.com/stonepagamentos/)[](https://x.com/sejastone/)[](https://www.instagram.com/stone/)[](https://br.linkedin.com/company/stone-co)[](https://www.youtube.com/channel/UCk4L4JykgoDkN8YeuxkNqIQ)

© Stone Instituição de Pagamento S.A. CNPJ 16.501.555/0001-57

Av. Rebouças, 2880, 4º andar, Pinheiros, CEP 05.402-500 – São Paulo/SP

Instituição de pagamento autorizada pelo Banco Central do Brasil, nas modalidades de credenciadora e emissora de moeda eletrônica.