Skip to main content
POST
/
api
/
v1
/
order
Criar pedido
curl --request POST \
  --url https://api.selltrust.com.br/api/v1/order \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "client_name": "<string>",
  "client_email": "<string>",
  "client_document": "<string>",
  "coupon_code": "<string>",
  "payment_method": "<string>",
  "items": [
    {}
  ],
  "bumps": [
    {}
  ],
  "tracking": {},
  "utm_source": "<string>",
  "utm_medium": "<string>",
  "utm_campaign": "<string>",
  "utm_term": "<string>",
  "utm_content": "<string>"
}
'
{
  "order_id": "uuid-do-pedido",
  "internal_id": "ST-XXXXXX",
  "status": "PENDING",
  "payment": {
    "payment_id": "id-externo",
    "pix_code": "00020126..."
  },
  "is_approved": false
}

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.

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).
​
Authorization
string
required
Token de acesso no formato Bearer <seu_token>.
​
client_name
string
required
Nome completo do cliente (3–255 caracteres).
​
client_email
string
required
E-mail válido do cliente.
​
client_document
string
CPF/CNPJ ou documento fiscal, se aplicável. Pode ser null.
​
coupon_code
string
Código de cupom ou null.
​
payment_method
string
required
Um de: PIX, CREDIT_CARD, MERCADO_PAGO.
​
items
array
required
Lista de itens. Cada item: product_id (UUID) e quantity (inteiro positivo). Pelo menos um item.
​
bumps
array
Order bumps opcionais (máx. 20). Cada entrada: bump_id (UUID) e product_id (UUID).
​
tracking
object
Rastreio de afiliado: ref e date (strings), ou null.
​
utm_source
string
UTM opcional (ex.: campanha).
​
utm_medium
string
​
utm_campaign
string
​
utm_term
string
​
utm_content
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. 
{
  "order_id": "uuid-do-pedido",
  "internal_id": "ST-XXXXXX",
  "status": "PENDING",
  "payment": {
    "payment_id": "id-externo",
    "pix_code": "00020126..."
  },
  "is_approved": false
}