Skip to main content
POST
/
api
/
v1
/
coupon
Criar Cupom
curl --request POST \
  --url https://api.selltrust.com.br/api/v1/coupon \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "code": "<string>",
  "discount_type": "<string>",
  "discount_value": 123,
  "min_order_value": 123,
  "max_uses": 123,
  "expires_at": "<string>",
  "active": true,
  "product_ids": [
    {}
  ]
}
'
{
  "id": "uuid-do-cupom",
  "store_id": "uuid-da-loja",
  "code": "PROMO10",
  "discount_type": "PERCENTAGE",
  "discount_value": 10,
  "min_order_value": null,
  "max_uses": null,
  "used_count": 0,
  "expires_at": null,
  "active": true,
  "product_ids": [],
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}

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.

Gera um código promocional. Pode ser de desconto fixo (FIXED) ou porcentagem (PERCENTAGE).
Authorization
string
required
Token de acesso no formato Bearer <seu_token>.
code
string
required
Código do cupom (mínimo de 3 caracteres).
discount_type
string
required
Tipo de desconto: PERCENTAGE ou FIXED.
discount_value
number
required
Valor do desconto. Ex: 10 para 10% ou R$10.
min_order_value
number
Valor mínimo do pedido para aplicar o cupom.
max_uses
number
Limite máximo de usos do cupom.
expires_at
string
Data de expiração no formato ISO 8601.
active
boolean
required
Status de ativação do cupom.
product_ids
array
required
Lista de IDs (UUID) de produtos válidos para o cupom. Array vazio aplica a todos.
{
  "id": "uuid-do-cupom",
  "store_id": "uuid-da-loja",
  "code": "PROMO10",
  "discount_type": "PERCENTAGE",
  "discount_value": 10,
  "min_order_value": null,
  "max_uses": null,
  "used_count": 0,
  "expires_at": null,
  "active": true,
  "product_ids": [],
  "created_at": "2024-01-01T00:00:00.000Z",
  "updated_at": "2024-01-01T00:00:00.000Z"
}