Consulta de pedidos — API Pública v1

Leitura de pedidos gerados a partir do checkout. O carrinho em aberto é documentado em Carrinho.

Base URL

https://{sua-loja}/api/v1/public/

Identificação do cliente

Envie o header Authorization: Bearer {access_token} obtido no Login (SSO). A listagem só responde para o próprio cliente.

GET /customer/{customer_uuid}/orders/

Lista os pedidos do cliente identificado, do mais recente para o mais antigo. customer_uuid precisa ser o do cliente do token; caso contrário, 404.

Query params

Resposta 200 OK

{
  "count": 12,
  "next": "https://sua-loja.com/api/v1/public/customer/511e9c46-.../orders/?p=2",
  "previous": null,
  "results": [
    {
      "id": 98765,
      "uuid": "a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "status": "PAG",
      "status_display": "Pagamento aprovado",
      "channel": "APP",
      "add_date": "2026-04-01T10:15:30",
      "item_total": 199.90,
      "discount_total": 0.0,
      "shipping_total": 0.0,
      "total": 199.90,
      "payment_method": "CartaoDeCredito",
      "installments": 3,
      "card_mask": "Terminado em 1111",
      "shipping_type": "PAC",
      "shipping_name": "PAC",
      "shipping_delivery_date": "2026-04-08",
      "shipping_detail_name": "Caroline Tartaro",
      "shipping_detail_postcode": "18055163",
      "items": [ { "sku": 18161, "name": "Kit Medidor de Glicemia", "quantity": 1.0, "unit_price": 199.90, "total_price": 199.90 } ],
      "payments": [ { "group": "CartaoDeCredito", "status": "CAPTURED", "installments": 3, "total": 199.90 } ],
      "trackers": [],
      "invoices": []
    }
  ]
}

GET /customer/{customer_uuid}/orders/{uuid}/

Detalhe de um pedido do cliente. 404 se o pedido não existir.

Resposta 200 OK

O pedido completo, no mesmo formato da listagem, acrescido de customer, dos endereços de cobrança e entrega (billing_detail_* e shipping_detail_*), de timeline e get_all_status (histórico e próximos status), de payments[] com as transações (forma, parcelas, status e, para PIX e boleto, os dados para pagamento), de trackers[] com os códigos de rastreio, de invoices[] com as notas fiscais e de localization (moeda e separadores).

GET /orders/{uuid}/

Detalhe de um pedido apenas pelo UUID, sem identificação do cliente. Mesmo formato da resposta acima. Usado em páginas de confirmação, links de acompanhamento e e-mails transacionais.

Trate o UUID do pedido como informação sensível. Quem tiver o link tem acesso ao detalhe do pedido. Não o exponha em URLs indexáveis nem em logs públicos.