Pular para o conteúdo principal
O pedido é o objeto que Listar pedidos e Buscar pedido devolvem. A conta vê os pedidos em que é dona e os de coprodução.
  • Formato fixo. Todo campo abaixo vem sempre no JSON; campo sem valor vem null, nunca ausente. A exceção são as chaves dentro de metadata, que só aparecem quando existem no pedido.
  • Valores em centavos, como inteiros: 27730 é R$ 277,30.
  • Datas em ISO 8601, UTC: 2026-10-14T13:05:22.418Z.
  • Valores novos. Listas de valores (como status) podem ganhar itens novos na v1. Trate um valor desconhecido sem falhar.
Coprodução. Com role: COPRODUCER, a conta vê os valores do pedido inteiro, não a parte dela na coprodução. Só tracking e navigator vêm null para o coprodutor.

​
Atributos

​
string
Tipo do objeto: sempre order.
​
string
Identificador do pedido, com prefixo ord_. Use-o como chave do pedido na sua base.
​
string
Papel da conta no pedido.
  • OWNER: a conta é dona do pedido.
  • COPRODUCER: a conta participa do pedido por coprodução. Vê os valores do pedido inteiro, não a parte dela; tracking e navigator vêm null.
​
string
Situação do pedido.
  • AWAITING_PAYMENT: PIX ou boleto emitido e ainda pagável. Também o pagamento dividido entre a primeira e a segunda parte, e o primeiro status do parcelado inteligente.
  • UNPAID: a cobrança foi tentada e não foi paga. Cartão recusado (inclusive pelo antifraude), PIX ou boleto expirado, período de teste de assinatura que terminou sem conversão, ou assinatura cancelada no prazo de inadimplência. Um cartão recusado no checkout aparece assim, com payment.status DECLINED e payment.decline_code preenchido.
  • PAID: todo pagamento cobrado está pago (no pagamento dividido, todas as partes). Um estorno parcial mantém PAID.
  • CANCELED: pagamento dividido não concluído em 20 minutos. As partes já pagas são estornadas.
  • REFUNDED: todo pagamento cobrado foi estornado por inteiro.
  • DISPUTED: chargeback em todo pagamento cobrado. Uma disputa ganha volta o pedido para PAID.
  • TRIAL: assinatura em período de teste, com o cartão guardado e sem cobrança. Os valores vêm 0.
  • SHIPPED, DELIVERED: reservados. Não são usados hoje.
A renovação de uma assinatura não muda o status do pedido: o pagamento novo entra no mesmo pedido e aparece em payment. Um pedido cuja cobrança falhou na infraestrutura da Zouti, sem chegar ao banco, não aparece nesta API.
​
string | null
Moeda do pedido, em ISO 4217 (ex. BRL).
​
integer
Valor cobrado no checkout, em centavos. No parcelado inteligente, o valor total do contrato.
​
integer | null
Soma de preço × quantidade dos produtos, em centavos.
​
integer | null
Valor total em BRL, em centavos. Hoje é igual a amount_total nos pedidos de infoproduto.
​
string
Instante de criação do pedido.
​
string | null
Instante em que o pedido foi pago. null quando não foi.
​
string | null
Instante do cancelamento. null quando não houve.
​
string | null
Instante (UTC, com milissegundos) da última mudança em algum campo deste objeto: status, valores, pagamento, estorno, cliente, endereço, itens, oferta, cupom, UTM ou metadados. Um reprocessamento interno que não muda nada do que a API devolve não avança este campo. null em pedido que ainda não passou pelo preenchimento inicial.É o campo da sincronização de pedidos, com sort=updated_at_asc e updated_gte.
​
object
Comprador.
​
object | null
Endereço de entrega informado no checkout. null quando o pedido não tem endereço.
​
object
Último pagamento do pedido: o mais recente pela data de criação. Na renovação de assinatura, no parcelado inteligente e numa nova tentativa, os valores são os desse último pagamento. Só no pagamento dividido (method MULTIPLE) os valores somam as partes pagas.
​
object[]
Produtos do pedido.
​
object | null
Oferta do checkout em que o pedido foi feito. null quando não há.
​
object | null
Cupom aplicado no pedido. null sem cupom.
​
object | null
Parâmetros UTM do checkout. null quando o pedido não tem UTM.
​
object | null
Parâmetros de rastreamento que vieram na URL do checkout (ex. sck, src, xcod), como chave → valor, com valores em texto. null quando o pedido não tem rastreamento ou quando a conta é coprodutora (role COPRODUCER).
​
object | null
Navegador do comprador no checkout. Nunca traz o IP. null quando o pedido não registrou navegador nem página de origem, ou quando a conta é coprodutora (role COPRODUCER).
​
object | null
Metadados comerciais do pedido. Cada chave só aparece quando existe no pedido.

​
Situações comuns

Como status e payment.status aparecem juntos nos casos mais frequentes: