Skip to main content
POST
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).
string
required
Token de acesso no formato Bearer <seu_token>.
string
required
Nome completo do cliente (3–255 caracteres).
string
required
E-mail válido do cliente.
string
CPF/CNPJ ou documento fiscal, se aplicável. Pode ser null.
string
Código de cupom ou null.
string
required
Um de: PIX, CREDIT_CARD, MERCADO_PAGO.
array
required
Lista de itens. Cada item: product_id (UUID) e quantity (inteiro positivo). Pelo menos um item.
array
Order bumps opcionais (máx. 20). Cada entrada: bump_id (UUID) e product_id (UUID).
object
Rastreio de afiliado: ref e date (strings), ou null.
string
UTM opcional (ex.: campanha).
string
string
string
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.