> ## Documentation Index
> Fetch the complete documentation index at: https://docs.selltrust.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criar pedido

Cria um novo pedido com a **mesma regra de negócio do checkout da loja** (cálculo de totais, cupom, order bumps, gateway de pagamento, afiliado e UTM). Útil para integrações que registam vendas fora do fluxo web (POS, app próprio, automações).

<ParamField header="Authorization" type="string" required>
  Token de acesso no formato `Bearer <seu_token>`.
</ParamField>

<ParamField body="client_name" type="string" required>
  Nome completo do cliente (3–255 caracteres).
</ParamField>

<ParamField body="client_email" type="string" required>
  E-mail válido do cliente.
</ParamField>

<ParamField body="client_document" type="string">
  CPF/CNPJ ou documento fiscal, se aplicável. Pode ser `null`.
</ParamField>

<ParamField body="coupon_code" type="string">
  Código de cupom ou `null`.
</ParamField>

<ParamField body="payment_method" type="string" required>
  Um de: `PIX`, `CREDIT_CARD`, `MERCADO_PAGO`.
</ParamField>

<ParamField body="items" type="array" required>
  Lista de itens. Cada item: `product_id` (UUID) e `quantity` (inteiro positivo). Pelo menos um item.
</ParamField>

<ParamField body="bumps" type="array">
  Order bumps opcionais (máx. 20). Cada entrada: `bump_id` (UUID) e `product_id` (UUID).
</ParamField>

<ParamField body="tracking" type="object">
  Rastreio de afiliado: `ref` e `date` (strings), ou `null`.
</ParamField>

<ParamField body="utm_source" type="string">
  UTM opcional (ex.: campanha).
</ParamField>

<ParamField body="utm_medium" type="string" />

<ParamField body="utm_campaign" type="string" />

<ParamField body="utm_term" type="string" />

<ParamField body="utm_content" type="string" />

## Resposta

Em caso de sucesso, o corpo inclui identificadores do pedido, estado e dados de pagamento (ex.: PIX) quando o valor total é maior que zero. Pedidos com total **0** podem ser aprovados automaticamente conforme a configuração da loja.

<ResponseExample>
  ```json Response theme={null}
  {
    "order_id": "uuid-do-pedido",
    "internal_id": "ST-XXXXXX",
    "status": "PENDING",
    "payment": {
      "payment_id": "id-externo",
      "pix_code": "00020126..."
    },
    "is_approved": false
  }
  ```
</ResponseExample>