Criar um pedido

Changed on Nov 3, 2026

post/orders

Request

Base URL
https://sandbox.api.pagseguro.com
URL
https://sandbox.api.pagseguro.com/orders
Auth
none required

Headers

Authorizationstring

Bearer TOKEN

Request body

reference_idstring

Identificador próprio atribuído para o pedido

notification_urlsstring[]

Objeto contendo as urls que receberão as notificações do pedido (por ora, somente aceitamos uma url apenas. Aceitamos mais urls em breve.)

Response

201

idstring

reference_idstring

created_atstring

chargesobject[]

Example response

{
  "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@test.com",
    "tax_id": "12345678909",
    "phones": [
      {
        "country": "55",
        "area": "11",
        "number": "999999999",
        "type": "MOBILE"
      }
    ]
  },
  "qr_codes": [
    {
      "id": "QRCO_86FE511B-E945-4FE1-BB5D-297974C0DB74",
      "amount": {
        "value": 500
      },
      "text": "00020101021226600016BR.COM.PAGSEGURO013686FE511B-E945-4FE1-BB5D-297974C0DB7452048999530398654045.005802BR5922Rafael Gouveia Firmino6009SAO PAULO63049879",
      "links": [
        {
          "rel": "QRCODE.PNG",
          "href": "https://sandbox.api.pagseguro.com/qrcode/QRCO_86FE511B-E945-4FE1-BB5D-297974C0DB74/png",
          "media": "image/png",
          "type": "GET"
        }
      ]
    }
  ],
  "links": [
    {
      "rel": "SELF",
      "href": "https://sandbox.api.pagseguro.com/orders/ORDE_F87334AC-BB8B-42E2-AA85-8579F70AA328",
      "media": "application/json",
      "type": "GET"
    }
  ]
}

Changes

Nov 3, 20260838a2b3f755 Revision changes
- breaking
  the request property /// became required
- breaking
  the request property / became required
- breaking
  the request property type changed from array to object
- breaking
  the response's body type changed from no type to object for status
- warning
  deleted the header request parameter x-idempotency-key
- info
  api operation id criar-pedido removed and replaced with create-order2
- info
  added the new optional request property ///
- info
  added the new optional request property
- info
  added the new optional request property /
- info
  added the new optional request property /
- info
  the header request parameter Authorization became optional
- info
  added the new PIX enum value to the request property ///
- info
  removed subschema #1: Criar Pedido subschema #2: Criar/Pag Cartão subschema #3: Criar/Pag Token Band VISA/MASTER CRED subschema #4: Criar/Pag Token Band VISA/MASTER DEB subschema #5: Criar/Pag Token Band ELO CRED subschema #6: Criar/Pag Token Band ELO DEB subschema #7: Criar/Pag Token PagBank subschema #8: Criar/Pag INITIAL - Indicação de Recorrência subschema #9: Criar/Pag SUBSEQUENT - Indicação de Recorrência subschema #10: Criar/Pag 3DS - Validação Externa CRED subschema #11: Criar/Pag 3DS - Validação Externa DEB subschema #12: Criar/Pag 3DS - Validação Interna subschema #13: Criar Pedido - 3DS Interna subschema #14: Criar/Pag Cartão - PCI subschema #15: Criar/Pag Pedido - Boleto subschema #16: Criar Pedido - QR Code - PIX subschema #17: Pedido - Facilitadores de Pagamento from the response body oneOf list for the response status
- info
  removed the non-success response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status

Operation history