API atual/Referência completa/Mini-loja WhatsApp: pedidos

Listar os pedidos

Lista os pedidos mais recentes do cliente identificado, com status, valor, itens e o que falta pagar.

É a aba "Pedidos" da mini-loja. Devolve os pedidos mais recentes da conta do cliente, inclusive os feitos antes no site ou por outro canal e ligados à mesma conta. Só existe para cliente identificado: visitante recebe 403 account_required.

Listar

GET/api/v1/storefront/wa-coex/orders/{token}Pública

Lista os últimos pedidos do cliente

A lista não tem paginação nem filtros: vêm os pedidos mais recentes, no máximo 30. Para ver um pedido com todos os detalhes, use Ver o pedido.

Parâmetros de caminho

tokenstringobrigatório

Token da mini-loja.

Exemplo de requisição

bash

curl "$BASE_URL/api/v1/storefront/wa-coex/orders/$TOKEN"

Resposta

200Pedidos do cliente

json

{
  "orders": [
    {
      "order_id": "9f4a6d2e-1b7c-4c53-8d21-5e0b6a7c1f33",
      "order_number": "1042",
      "status": "P",
      "status_code": "pending",
      "status_name": "Aguardando pagamento",
      "status_color": "#f59e0b",
      "payment_status": "P",
      "total_cents": 16387,
      "created_at": "2026-10-11T18:42:10Z",
      "item_count": 2,
      "item_preview": "Notebook Slim Rosa",
      "image_url": "/uploads/exemplo/notebook.png",
      "stage": "incoming"
    }
  ]
}

Campos da resposta

ordersarray

Pedidos, do mais novo para o mais antigo. [] quando não há.

order_iduuid

Id do pedido.

order_numberstring

Número para exibir ao cliente.

statusstring

Status do pedido, a letra de 1 caractere gravada (por exemplo P). Use status_code e status_name para decidir e exibir.

status_codestring

Código do status no cadastro da loja (por exemplo pending, paid, shipped, cancelled). Cada loja pode configurar o seu fluxo.

status_namestring

Nome do status em português, como a loja o chama.

status_colorstring

Cor do status no painel da loja.

payment_statusstring

Status do pagamento, em letra (P pendente, C pago, F recusado...).

total_centsinteger

Total em centavos.

created_atstring

Quando o pedido foi criado, em RFC 3339.

item_countinteger

Quantidade de itens.

item_previewstring

Nome dos primeiros itens (até 3), para o subtítulo do cartão.

image_urlstring

Foto do primeiro item.

stagestring

incomingpreparingoutdoneclosed

Etapa na régua da loja: incoming ainda não aceito, preparing aceito e em preparo, out enviado ou em rota, done entregue, closed cancelado ou estornado. É a mesma régua que decide se o cliente pode cancelar.

payment_statestring

refusedanalysis

Só aparece quando o pagamento precisa de destaque por cima do status do pedido: refused (recusado) ou analysis (cartão em análise no banco). Ausente: o status já conta a história.

cancel_requestedboolean

O cliente já pediu à loja para cancelar este pedido. Omitido quando false.

Erros

Status	Quando	Corpo
403	O token não tem conta identificada.	`{"error":"account_required","message":"Entre na sua conta para ver seus pedidos."}`
503	Não foi possível resolver a conta agora.	`{"error":"account_resolution_unavailable"}`

Veja também