Buscar pedido

curl --request GET \
  --url https://api.zouti.com.br/v1/orders/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zouti.com.br/v1/orders/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zouti.com.br/v1/orders/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "object": "order",
  "id": "ord_8k2m4q6s1v3x5z7b9d0f2h",
  "role": "OWNER",
  "status": "PAID",
  "currency": "BRL",
  "amount_total": 27730,
  "amount_subtotal": 29700,
  "amount_in_brl": 27730,
  "created_at": "2026-10-14T13:05:22.418Z",
  "paid_at": "2026-10-14T13:05:24.902Z",
  "canceled_at": null,
  "updated_at": "2026-10-14T13:05:25.117Z",
  "customer": {
    "name": "Maria Oliveira",
    "email": "maria.oliveira@example.com",
    "phone": "+5511999998888",
    "document": "12345678909",
    "document_type": "CPF"
  },
  "shipping_address": {
    "line1": "Rua das Flores",
    "line2": "123",
    "line3": "Apto 45",
    "neighborhood": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR",
    "postal_code": "01001000",
    "full_name": "Maria Oliveira"
  },
  "payment": {
    "method": "CREDIT_CARD",
    "status": "PAID",
    "installments": 1,
    "amount": 27730,
    "interest_amount": 0,
    "discount_amount": 1970,
    "fee": 1386,
    "amount_refunded": 0,
    "refunded_at": null,
    "decline_code": null,
    "decline_message": null,
    "card": {
      "brand": "MASTERCARD",
      "last4": "4242"
    }
  },
  "items": [
    {
      "product_id": "prod_3n7p1r5t9w2y4a6c8e0g1j",
      "name": "Curso Completo de Fotografia",
      "quantity": 1,
      "unit_price": 19700,
      "sub_total": 19700,
      "currency": "BRL",
      "offer_id": "prod_offer_5d1f3h7k9m2p4r6t8v0x2z",
      "plan_id": null,
      "order_bump_id": null
    },
    {
      "product_id": "prod_6b8d0f2h4k6m8p0r2t4v6x",
      "name": "Pacote de Presets",
      "quantity": 1,
      "unit_price": 10000,
      "sub_total": 10000,
      "currency": "BRL",
      "offer_id": null,
      "plan_id": null,
      "order_bump_id": "ob_2c4e6g8j0l2n4q6s8u0w2y"
    }
  ],
  "offer": {
    "id": "prod_offer_5d1f3h7k9m2p4r6t8v0x2z",
    "name": "Oferta de lançamento"
  },
  "promocode": {
    "code": "BEMVINDO10",
    "description": "10% de desconto no curso",
    "amount": -1970
  },
  "utm": {
    "utm_source": "instagram",
    "utm_medium": "social",
    "utm_campaign": "lancamento-outubro",
    "utm_term": null,
    "utm_content": "stories"
  },
  "tracking": {
    "sck": "parceiro-123",
    "src": "bio"
  },
  "navigator": {
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 Instagram 350.0.0",
    "referer": "https://www.instagram.com/",
    "device": "Mobile",
    "browser": "Instagram",
    "origin": "instagram.com"
  },
  "metadata": {}
}

Buscar pedido

curl --request GET \
  --url https://api.zouti.com.br/v1/orders/{id} \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.zouti.com.br/v1/orders/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zouti.com.br/v1/orders/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

{
  "object": "order",
  "id": "ord_8k2m4q6s1v3x5z7b9d0f2h",
  "role": "OWNER",
  "status": "PAID",
  "currency": "BRL",
  "amount_total": 27730,
  "amount_subtotal": 29700,
  "amount_in_brl": 27730,
  "created_at": "2026-10-14T13:05:22.418Z",
  "paid_at": "2026-10-14T13:05:24.902Z",
  "canceled_at": null,
  "updated_at": "2026-10-14T13:05:25.117Z",
  "customer": {
    "name": "Maria Oliveira",
    "email": "maria.oliveira@example.com",
    "phone": "+5511999998888",
    "document": "12345678909",
    "document_type": "CPF"
  },
  "shipping_address": {
    "line1": "Rua das Flores",
    "line2": "123",
    "line3": "Apto 45",
    "neighborhood": "Centro",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR",
    "postal_code": "01001000",
    "full_name": "Maria Oliveira"
  },
  "payment": {
    "method": "CREDIT_CARD",
    "status": "PAID",
    "installments": 1,
    "amount": 27730,
    "interest_amount": 0,
    "discount_amount": 1970,
    "fee": 1386,
    "amount_refunded": 0,
    "refunded_at": null,
    "decline_code": null,
    "decline_message": null,
    "card": {
      "brand": "MASTERCARD",
      "last4": "4242"
    }
  },
  "items": [
    {
      "product_id": "prod_3n7p1r5t9w2y4a6c8e0g1j",
      "name": "Curso Completo de Fotografia",
      "quantity": 1,
      "unit_price": 19700,
      "sub_total": 19700,
      "currency": "BRL",
      "offer_id": "prod_offer_5d1f3h7k9m2p4r6t8v0x2z",
      "plan_id": null,
      "order_bump_id": null
    },
    {
      "product_id": "prod_6b8d0f2h4k6m8p0r2t4v6x",
      "name": "Pacote de Presets",
      "quantity": 1,
      "unit_price": 10000,
      "sub_total": 10000,
      "currency": "BRL",
      "offer_id": null,
      "plan_id": null,
      "order_bump_id": "ob_2c4e6g8j0l2n4q6s8u0w2y"
    }
  ],
  "offer": {
    "id": "prod_offer_5d1f3h7k9m2p4r6t8v0x2z",
    "name": "Oferta de lançamento"
  },
  "promocode": {
    "code": "BEMVINDO10",
    "description": "10% de desconto no curso",
    "amount": -1970
  },
  "utm": {
    "utm_source": "instagram",
    "utm_medium": "social",
    "utm_campaign": "lancamento-outubro",
    "utm_term": null,
    "utm_content": "stories"
  },
  "tracking": {
    "sck": "parceiro-123",
    "src": "bio"
  },
  "navigator": {
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 18_0 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148 Instagram 350.0.0",
    "referer": "https://www.instagram.com/",
    "device": "Mobile",
    "browser": "Instagram",
    "origin": "instagram.com"
  },
  "metadata": {}
}

Devolve um objeto pedido pelo id (ord_...), quando a conta é dona do pedido ou participa dele por coprodução.

Mesmo 404 para pedido de outra conta. Um pedido que não existe e um pedido de outra conta recebem a mesma resposta 404 resource_missing. A API não revela se um id existe fora da sua conta.
Mesmo formato da lista. O pedido devolvido aqui é igual ao que aparece em data de Listar pedidos: os mesmos campos, com as mesmas regras de coprodução.

Autorizações

Authorization

string

header

obrigatório

Chave de API da conta (zt_live_...), criada em Configurações → Chaves de API no dashboard.

Parâmetros de caminho

string

obrigatório

Identificador do pedido (ord_...).

Resposta

O pedido.

Pedido da conta. O formato é fixo: campo sem valor vem null, nunca ausente. Valores monetários em centavos (inteiros).

object

enum<string>

obrigatório

Tipo do objeto: sempre order.

Opções disponíveis:

order

string

obrigatório

Identificador do pedido (ord_...).

role

enum<string>

obrigatório

OWNER quando a conta é dona do pedido; COPRODUCER quando participa por coprodução. O coprodutor vê os valores do pedido inteiro, não a parte dele; só tracking e navigator vêm null.

Opções disponíveis:

OWNER,

COPRODUCER

status

enum<string>

obrigatório

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: cobrança tentada sem pagamento — cartão recusado (inclusive pelo antifraude), PIX ou boleto expirado, período de teste de assinatura expirado sem conversão, assinatura cancelada no prazo de inadimplência.
PAID: todo pagamento cobrado está pago (no pagamento dividido, todas as partes). Estorno parcial mantém PAID.
CANCELED: pagamento dividido não concluído em 20 minutos; as partes pagas são estornadas.
SHIPPED, DELIVERED: reservados; não são usados hoje.
REFUNDED: todo pagamento cobrado foi estornado por inteiro.
DISPUTED: chargeback em todo pagamento cobrado; disputa ganha volta a PAID.
TRIAL: assinatura em período de teste, cartão guardado sem cobrança; valores 0.

A renovação de assinatura não muda o status do pedido: o pagamento novo entra no mesmo pedido e aparece em payment. Um pedido pode mudar de status mais de uma vez; aceite qualquer transição.

Opções disponíveis:

AWAITING_PAYMENT,

UNPAID,

PAID,

CANCELED,

SHIPPED,

DELIVERED,

REFUNDED,

DISPUTED,

TRIAL

currency

string | null

obrigatório

Moeda do pedido (ISO 4217, ex. BRL).

amount_total

integer

obrigatório

Valor cobrado no checkout, em centavos (parcelado inteligente, o valor total do contrato).

amount_subtotal

integer | null

obrigatório

Soma de preço × quantidade dos produtos, em centavos.

amount_in_brl

integer | null

obrigatório

Valor total em BRL, em centavos. Hoje igual a amount_total nos pedidos de infoproduto.

created_at

string<date-time>

obrigatório

Instante de criação do pedido.

paid_at

string<date-time> | null

obrigatório

Instante em que o pedido foi pago; null quando não há.

canceled_at

string<date-time> | null

obrigatório

Instante do cancelamento; null quando não há.

updated_at

string<date-time> | null

obrigatório

Instante (UTC, com milissegundos) em que algum campo deste objeto mudou pela última vez: status, valores, pagamento, estorno, cliente, endereço, itens, oferta, cupom, UTM ou metadata. 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.

customer

object

obrigatório

Comprador.

Show child attributes

shipping_address

object | null

obrigatório

Endereço de entrega informado no checkout; null quando o pedido não tem endereço.

Show child attributes

payment

object

obrigatório

Último pagamento do pedido (o mais recente pela data de criação). Os valores somam as partes pagas só no pagamento dividido (method MULTIPLE); nos demais casos (renovação de assinatura, parcelado inteligente, nova tentativa) são os do último pagamento.

Show child attributes

items

object[]

obrigatório

Produtos do pedido.

Show child attributes

offer

object | null

obrigatório

Oferta do checkout em que o pedido foi feito; null quando não há.

Show child attributes

promocode

object | null

obrigatório

Cupom aplicado no pedido; null sem cupom.

Show child attributes

utm

object | null

obrigatório

Parâmetros UTM do checkout; null quando o pedido não tem UTM.

Show child attributes

tracking

object | null

obrigatório

Parâmetros de rastreamento que vieram na URL do checkout (ex. sck, src, xcod), como chave → valor. null quando o pedido não tem rastreamento ou quando quem consulta é coprodutor (role: COPRODUCER).

Show child attributes

navigator

object | null

obrigatório

Navegador do comprador no checkout. Nunca traz o IP. null quando o pedido não registrou navegador nem página de origem, ou quando quem consulta é coprodutor (role: COPRODUCER).

Show child attributes

metadata

object | null

obrigatório

Metadados comerciais do pedido. Cada chave só aparece quando existe no pedido.

Show child attributes

Começar

Conceitos

Referência

Changelog

Buscar pedido

Autorizações

Parâmetros de caminho

Resposta