Skip to main content
POST
/
v1
/
discount-coupons
curl -u "pb_xxx:sk_xxx" -X POST \
  -H "Content-Type: application/json" \
  -d '{ "code": "BEMVINDO10", "discount_type": "percentage", "discount_value": 10 }' \
  "https://api.sortify.com.br/v1/discount-coupons"

{
  "success": true,
  "message": "Cupom criado com sucesso",
  "data": {
    "id": "5f4e3d2c-1b0a-9f8e-7d6c-5b4a3f2e1d0c",
    "code": "COMBO100",
    "discount_type": "bundle",
    "discount_value": 2990,
    "bundle_quantity": 100,
    "campaign_id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c",
    "max_uses": null,
    "current_uses": 0,
    "min_order_value": null,
    "valid_from": null,
    "valid_until": null,
    "is_active": true,
    "created_at": "2026-07-06T12:00:00.000Z"
  }
}
Cria um cupom de desconto na conta. O código é normalizado para MAIÚSCULAS e deve ser único na conta.

​
Body

​
code
string
required
Código do cupom (3–50 caracteres). Normalizado para MAIÚSCULAS.
​
discount_type
string
required
percentage (percentual sobre o pedido), fixed (valor fixo de desconto) ou bundle (preço total fechado para uma quantidade exata de cotas).
​
discount_value
number
required
  • percentage: percentual de 1 a 100.
  • fixed: desconto em centavos (ex.: 500 = R$ 5,00 de desconto).
  • bundle: preço total fechado em centavos (ex.: 2990 = as cotas saem por R$ 29,90).
​
bundle_quantity
number
Obrigatório quando discount_type é bundle: quantidade exata de cotas que o pedido precisa ter para destravar o preço fechado.
​
campaign_id
string
Restringe o cupom a uma ação (UUID). Omitido = vale para todas as ações da conta.
​
max_uses
number
Limite de usos (mínimo 1). Omitido = ilimitado.
​
min_order_value
number
Valor mínimo do pedido em centavos.
​
valid_from
string
Início da validade (ISO 8601).
​
valid_until
string
Fim da validade (ISO 8601).
​
is_active
boolean
default:"true"
Se o cupom já nasce ativo.

​
Erros

HTTPCódigoQuando ocorre
400COUPON_PERCENTAGE_TOO_HIGHpercentage com valor acima de 100
400COUPON_BUNDLE_QUANTITY_REQUIREDbundle sem bundle_quantity
400COUPON_CODE_ALREADY_EXISTSJá existe cupom com esse código na conta
404CAMPAIGN_NOT_FOUNDcampaign_id inexistente ou de outra conta
curl -u "pb_xxx:sk_xxx" -X POST \
  -H "Content-Type: application/json" \
  -d '{ "code": "BEMVINDO10", "discount_type": "percentage", "discount_value": 10 }' \
  "https://api.sortify.com.br/v1/discount-coupons"

{
  "success": true,
  "message": "Cupom criado com sucesso",
  "data": {
    "id": "5f4e3d2c-1b0a-9f8e-7d6c-5b4a3f2e1d0c",
    "code": "COMBO100",
    "discount_type": "bundle",
    "discount_value": 2990,
    "bundle_quantity": 100,
    "campaign_id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c",
    "max_uses": null,
    "current_uses": 0,
    "min_order_value": null,
    "valid_from": null,
    "valid_until": null,
    "is_active": true,
    "created_at": "2026-07-06T12:00:00.000Z"
  }
}