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\":\"MEUCIQDHvDj8srv0WDR7gTY6pVXzbxI9zyfVf51faFNWbdcSKwIgR4uBoacP3M1xXoiJldCSkrqE7FlYk8neH3+ws5j9yM4\\u003d\",\"intermediateSigningKey\":{\"signedKey\":\"{\\\"keyValue\\\":\\\"MFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAE7BTuiSa1PsuZb7XHkpfmDxtDf5GBC1S+6OmyMD3norKhNW2xBsmXI5mFsZ1sIoh+S0XJJfGsSguuOcXYEvSVRg\\\\u003d\\\\u003d\\\",\\\"keyExpiration\\\":\\\"1715967637711\\\"}\",\"signatures\":[\"MEUCIQC5BL11cdKLzEqg1Oz2OCtcHPPp12OUz/sza70EUtzX+QIgFb2oAXdnA9pF0ZySTeSpzAjq+PVDubZmdH/cBxJ3lx4\\u003d\"]},\"protocolVersion\":\"ECv2\",\"signedMessage\":\"{\\\"encryptedMessage\\\":\\\"yIVMmvdOfN+Vk7pBdM9kPNWKh9oNAGsX+98vOTWMILil7qVyrTbK3WBmFdGP/ZQ9z1eXmq6o6xBJFCPJ9hKTJ+eIZCA5UlLzFoFH5XmJss1Y9sVhcv5K1m+bLTZy7c9qXxitSUil+TaLWTkw42GKmG5nc9MoDRcvizPk3P4bPbeZuL0oK4LeVJz15m5+k3ADQzP+d4BslGjv1SwLR9jnks4L92iv6Mrxlj5mVfJxSPlGLPsYVqoyPRxIEtzZ3GrWtxhEU60EaTFMOWcZ3g60RYdAq64shc4hqiiJGvuGS5R27NgRZgWRO0N/1GxxzAiOh73B448iUvGmMmXOl1Y9mZp6j1mqw0OR5JBtW8H/61gNoAgslj7eJ3AZj1/bB6iVbc9pnqmw03qQWz8annvPoEDWkp60Tm84yDLo4CubB7cqA/DwhP3w9mmM4b78jm09rDnIzDX72spWp63SqbAqRBGCRIrq+uk//zvK582ZbQpupMGzYecz1faKLESs5efsnTbADb6mq4IgCX0wXTc+cQzi9ods356nK/r/1OiR9i1y6zFp8yp4XtFGbj96/mztjbaeuBXqhW7cQRcRCoT8I2k3RQ\\\\u003d\\\\u003d\\\",\\\"ephemeralPublicKey\\\":\\\"BLLrVSr/lt1hxnYEKzXJ0vwLv5LI8UWZpNNQEeo3rjVTlj/l46/xuIKgKDVGYepb7buwZ5ZuxOc4PqAWguCg+1A\\\\u003d\\\",\\\"tag\\\":\\\"XlhrDBFo1GbRR0zF9zCAjDVlY2vd3ci71D/yHOHNbj4\\\\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