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"
curl -u "pb_xxx:sk_xxx" -X POST \
-H "Content-Type: application/json" \
-d '{
"code": "DESCONTO5",
"discount_type": "fixed",
"discount_value": 500,
"min_order_value": 2000,
"max_uses": 100
}' \
"https://api.sortify.com.br/v1/discount-coupons"
curl -u "pb_xxx:sk_xxx" -X POST \
-H "Content-Type: application/json" \
-d '{
"code": "COMBO100",
"discount_type": "bundle",
"discount_value": 2990,
"bundle_quantity": 100,
"campaign_id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c"
}' \
"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"
}
}
Cupons de desconto
Criar cupom
Cria um cupom de desconto percentual, fixo ou de preço fechado
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"
curl -u "pb_xxx:sk_xxx" -X POST \
-H "Content-Type: application/json" \
-d '{
"code": "DESCONTO5",
"discount_type": "fixed",
"discount_value": 500,
"min_order_value": 2000,
"max_uses": 100
}' \
"https://api.sortify.com.br/v1/discount-coupons"
curl -u "pb_xxx:sk_xxx" -X POST \
-H "Content-Type: application/json" \
-d '{
"code": "COMBO100",
"discount_type": "bundle",
"discount_value": 2990,
"bundle_quantity": 100,
"campaign_id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c"
}' \
"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
string
required
Código do cupom (3–50 caracteres). Normalizado para MAIÚSCULAS.
string
required
percentage (percentual sobre o pedido), fixed (valor fixo de desconto) ou bundle (preço total fechado para uma quantidade exata de cotas).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).
number
Obrigatório quando
discount_type é bundle: quantidade exata de cotas que o pedido precisa ter para destravar o preço fechado.string
Restringe o cupom a uma ação (UUID). Omitido = vale para todas as ações da conta.
number
Limite de usos (mínimo 1). Omitido = ilimitado.
number
Valor mínimo do pedido em centavos.
string
Início da validade (ISO 8601).
string
Fim da validade (ISO 8601).
boolean
default:"true"
Se o cupom já nasce ativo.
Erros
| HTTP | Código | Quando ocorre |
|---|---|---|
400 | COUPON_PERCENTAGE_TOO_HIGH | percentage com valor acima de 100 |
400 | COUPON_BUNDLE_QUANTITY_REQUIRED | bundle sem bundle_quantity |
400 | COUPON_CODE_ALREADY_EXISTS | Já existe cupom com esse código na conta |
404 | CAMPAIGN_NOT_FOUND | campaign_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"
curl -u "pb_xxx:sk_xxx" -X POST \
-H "Content-Type: application/json" \
-d '{
"code": "DESCONTO5",
"discount_type": "fixed",
"discount_value": 500,
"min_order_value": 2000,
"max_uses": 100
}' \
"https://api.sortify.com.br/v1/discount-coupons"
curl -u "pb_xxx:sk_xxx" -X POST \
-H "Content-Type: application/json" \
-d '{
"code": "COMBO100",
"discount_type": "bundle",
"discount_value": 2990,
"bundle_quantity": 100,
"campaign_id": "a3f1c9e2-5b7d-4e8a-9c01-2d3e4f5a6b7c"
}' \
"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"
}
}