Esse guia descreve como criar um pedido utilizando a API de pedidos do PagBank. Essa é a abordagem mais simples para se criar um pedido apresentada nos Casos de uso da API.
Crie o pedido
Com os dados do pedido em mãos você pode criá-lo 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. No entanto, como esse processo não envolve o pagamento, você não deve enviar o objeto charge dentro do objeto Order.
Abaixo você encontra um exemplo de requisição e resposta ao endpoint Criar pedido.
curl --request POST \
--url https://sandbox.api.pagseguro.com/orders \
--header 'Authorization: Bearer <token>' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"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": "BRA",
"postal_code": "01452002"
}
},
"notification_urls": [
"https://meusite.com/notificacoes"
]
}
'
{
"id": "ORDE_F87334AC-BB8B-42E2-AA85-8579F70AA328",
"reference_id": "ex-00001",
"created_at": "2020-11-21T23:23:22.69-03:00",
"shipping": {
"address": {
"street": "Avenida Brigadeiro Faria Lima",
"number": "1384",
"complement": "apto 12",
"locality": "Pinheiros",
"city": "São Paulo",
"region_code": "SP",
"country": "BRA",
"postal_code": "01452002"
}
},
"items": [
{
"reference_id": "referencia do item",
"name": "nome do item",
"quantity": 1,
"unit_amount": 500
}
],
"customer": {
"name": "Jose da Silva",
"email": "[email protected]",
"tax_id": "12345678909",
"phones": [
{
"country": "55",
"area": "11",
"number": "999999999",
"type": "MOBILE"
}
]
},
"charges": [],
"qr_codes": [],
"links": []
}
Para verificar se o seu pedido foi criado de forma adequada, a resposta deve conter o parâmetro id, utilizado para identificar o pedido.
Depois de criar o pedido e ter o valor do id de identificação do pedido, você pode utilizar o endpoint Pagar pedido para gerar a cobrança. O Objeto Charge com os dados do meio de pagamento e do valor da cobrança serão eviados ao PagBank através dessa requisição.