Criar e pagar um pedido com Google Pay™

Nesta página descreveremos o fluxo de criação e pagamento de um pedido com Google Pay™.

📘

Integre com Google Pay

Antes de poder criar um pedido é necessário haver integrado com o Google Pay™ para poder realizar chamadas na API. Acesse a página de Como integrar com Google Pay para saber como.

Criação do pedido

De posse dos dados do cartão e do pedido, você pode criar o pedido utilizando o endpoint Criar pedido.

Para realizar a requisição ao endpoint Criar pedido, você precisa fornecer no corpo da requisição os dados descritos no Objeto Order. Os dados do pagamento devem ser adicionados ao objeto charge, a página Objeto Charge descreve em detalhes cada um dos parâmetros que devem ser incluídos.

Para transações com o Google Pay™, sempre será obrigatório o envio do objeto wallet, com os campos type e keypreenchidos com valores básicos.

ParâmetroDescrição
charges.card.wallet.typeTipo de wallet, para esse cenário deverá ser enviado o valor GOOGLE_PAY.
charges.card.wallet.keyCredencial de pagamento devolvida pelo Google.

O bloco de código abaixo mostra um Request e Response de uma transação, enviando o objeto wallet.

curl --location --request POST 'https: //sandbox.api.pagseguro.com/orders' \
--header 'Authorization: Bearer {
  {token
  }
}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "reference_id": "ex-00001",
  "customer": {
    "name": "Jose da Silva",
    "email": "[email protected]",
    "tax_id": "12345678909",
    "phones": [
      {
        "country": "55",
        "area": "11",
        "number": "999999999",
        "type": "MOBILE"
      }
    ]
  },
  "items": [
    {
      "reference_id": "referencia do item",
      "name": "nome do item",
      "quantity": 1,
      "unit_amount": 500
    }
  ],
  "shipping": {
    "address": {
      "street": "Avenida Brigadeiro Faria Lima",
      "number": "1384",
      "complement": "apto 12",
      "locality": "Pinheiros",
      "city": "São Paulo",
      "region_code": "SP",
      "country": "BRASIL",
      "postal_code": "01452002"
    }
  },
  "notification_urls": [
    "https://meusite.com/notificacoes"
  ],
  "charges": [
    {
      "reference_id": "ex-00001",
      "description": "motivo da cobrança",
      "amount": {
        "value": 10526,
        "currency": "BRL"
      },
      "payment_method": {
        "type": "CREDIT_CARD",
        "installments": 2,
        "capture": true,
        "card": {
          "holder": {
            "name": "Jose da Silva"
          }
	    "wallet": {
	    "type": "GOOGLE_PAY",      
      "key":"{\"signature\":\"MEYCIQCeQyVFXO4V59nl/3hNmr9q+l4H8IR3FzsCYHLEers1OwIhAKbd5ky9Ae0yUelIWFvTgiS+kdP98g8cTNb2bzTB6x9V\",\"protocolVersion\":\"ECv1\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"5s/VktkcDzWBcbcJrabr63HLgGPMR3lhm9bluKxcmYmesZAb8exQE4zWHdZ+YA5JrB5J5EPwoKD/RNq5LyL4n6aYu6JFYAEz0RvBveBfbQNXqOCevE6RAGhnFY+Sn1M+a8vScFgSoI7OHvWkR6+N5wxsuIE891sa0oUK128AF+Q2kx229ajUkQXPOHtkq2zrLB9knSn9sio2Txq2MBZwir7TR4T914cSCS8/09bWtm2fkzVemU1jFXhNTvuszSCV38N004Bs0Hplli/kXMhdKD1FBKZ/Ubtz25mqZFK2WldlJJJK7GRyq+V5wsxl7EcZJ8O7ZViMBQbpTfqDPSEkJLVEJ/T3cdF6tAXxrD1P4gMnCG1yb/ktZJrZUDij6hNbzJBPSGhfm5nKIE9eQryzBB+TgW1G08A+OeFN3X8i+jdu3BI78VSeU+ATNxyv7mPqAxKZd+Zyrgw5PC0hR6kZZZHc+173llE0Bx9XyvuEBo70hhvPCbOC7tZ+jWF6UebCARy9aeu6f/QPdscHOtT2ss6WsPsDEAhcd+s\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BKgxtvgEA8L9alRaQOyUZsN9uPrelaCPmgxgsbgWfDhZFCegguL0XJ0FOrOms1Xm5gG6qtDA9i/s3lIW2wanhaA\\\\u003d\\\",\\\"tag\\\":\\\"eI7azYRt0OLdjIoiuod8V/SlycWAaRJ4T+Ze6OKgmK0\\\\u003d\\\"}\"}"" 
	   } 
       }
      },
      },
      "notification_urls": [
        "https://yourserver.com/nas_ecommerce/277be731-3b7c-4dac-8c4e-4c3f4a1fdc46/"
      ]
    }
  ]
}'


curl --location --response POST 'https: //sandbox.api.pagseguro.com/orders' \
--header 'Authorization: Bearer {
  {token
  }
}' \
--header 'Content-Type: application/json' \
--data-raw '{
  "reference_id": "ex-00001",
  "customer": {
    "name": "Jose da Silva",
    "email": "[email protected]",
    "tax_id": "12345678909",
    "phones": [
      {
        "country": "55",
        "area": "11",
        "number": "999999999",
        "type": "MOBILE"
      }
    ]
  },
  "items": [
    {
      "reference_id": "referencia do item",
      "name": "nome do item",
      "quantity": 1,
      "unit_amount": 500
    }
  ],
  "shipping": {
    "address": {
      "street": "Avenida Brigadeiro Faria Lima",
      "number": "1384",
      "complement": "apto 12",
      "locality": "Pinheiros",
      "city": "São Paulo",
      "region_code": "SP",
      "country": "BRASIL",
      "postal_code": "01452002"
    }
  },
  "notification_urls": [
    "https://meusite.com/notificacoes"
  ],
  "charges": [
    {
      "reference_id": "ex-00001",
      "description": "motivo da cobrança",
      "amount": {
        "value": 10526,
        "currency": "BRL"
      },
      "payment_method": {
        "type": "CREDIT_CARD",
        "installments": 2,
        "capture": true,
        "card": {
          "store": true,
          "number": "4111111111111111",
          "exp_month": "03",
          "exp_year": "2026",
          "security_code": "123",
          "holder": {
            "name": "Jose da Silva"
          }
        }
      },
      },
      "notification_urls": [
        "https://yourserver.com/nas_ecommerce/277be731-3b7c-4dac-8c4e-4c3f4a1fdc46/"
      ]
    }
  ]
}'

Cartões de teste

Para a realização do fluxo de testes é necessário que o e-mail da conta de desenvolvedor do Google esteja cadastrado no grupo.

Assim será possível utilizar os cartões disponibilizados pelo Pagbank, passando os seguintes parâmetros abaixo no tokenizationSpecification :

  • gateway: pagbank
  • gatewayMerchantId: ID da conta (pode ser solicitado à equipe do Pagbank).

Uma vez cadastrado e passados os parâmetros, será disponibilizada a listagem de cartões de teste para utilizar no ambiente de sandbox. A tabela a seguir lista os cartões disponíveis:

SituaçãoDados do cartão
Transação aprovada MastercardNúmero do cartão: 5240082975622454
Data de Expiração: 12/2026
Transação negada MastercardNúmero do cartão: 5530062640663264
Data de Expiração: 12/2026
Transação aprovada VisaNúmero do cartão: 4539620659922097
Data de Expiração: 12/2026
Transação negada VisaNúmero do cartão: 4929291898380766
Data de Expiração: 12/2026