Atualizar faixa de desconto
curl --request PATCH \
--url https://apiv3.usecorvex.com.br/api/v1/discount-ranges/{discountRangeId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Store-Id: <x-store-id>' \
--data '
{
"name": "Progressivo no carrinho",
"ruleType": "CART_VALUE",
"appliesToAllProducts": true,
"applyDiscountTo": "ENTIRE_CART",
"itemRangeStart": null,
"itemRangeEnd": null,
"itemRangeOrderBy": null,
"startAt": null,
"endAt": null,
"active": true,
"priority": 1,
"tiers": [
{
"minValue": 100,
"maxValue": null,
"minQuantity": null,
"maxQuantity": null,
"discountType": "PERCENT",
"discountAmount": 10,
"position": 1
}
],
"productIds": []
}
'const options = {
method: 'PATCH',
headers: {
'X-Store-Id': '<x-store-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Progressivo no carrinho',
ruleType: 'CART_VALUE',
appliesToAllProducts: true,
applyDiscountTo: 'ENTIRE_CART',
itemRangeStart: null,
itemRangeEnd: null,
itemRangeOrderBy: null,
startAt: null,
endAt: null,
active: true,
priority: 1,
tiers: [
{
minValue: 100,
maxValue: null,
minQuantity: null,
maxQuantity: null,
discountType: 'PERCENT',
discountAmount: 10,
position: 1
}
],
productIds: []
})
};
fetch('https://apiv3.usecorvex.com.br/api/v1/discount-ranges/{discountRangeId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/discount-ranges/{discountRangeId}"
payload = {
"name": "Progressivo no carrinho",
"ruleType": "CART_VALUE",
"appliesToAllProducts": True,
"applyDiscountTo": "ENTIRE_CART",
"itemRangeStart": None,
"itemRangeEnd": None,
"itemRangeOrderBy": None,
"startAt": None,
"endAt": None,
"active": True,
"priority": 1,
"tiers": [
{
"minValue": 100,
"maxValue": None,
"minQuantity": None,
"maxQuantity": None,
"discountType": "PERCENT",
"discountAmount": 10,
"position": 1
}
],
"productIds": []
}
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"discountRange": {
"id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"storeId": "11111111-1111-4111-8111-111111111111",
"name": "Progressivo no carrinho",
"ruleType": "CART_VALUE",
"appliesToAllProducts": true,
"applyDiscountTo": "ENTIRE_CART",
"itemRangeStart": null,
"itemRangeEnd": null,
"itemRangeOrderBy": null,
"startAt": null,
"endAt": null,
"active": false,
"priority": 1,
"tiers": [
{
"id": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
"minValue": 100,
"maxValue": null,
"minQuantity": null,
"maxQuantity": null,
"discountType": "PERCENT",
"discountAmount": 10,
"position": 1
}
],
"productIds": [],
"createdAt": "2026-09-24T14:00:00.000Z",
"updatedAt": "2026-09-24T14:00:00.000Z"
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"error": {
"message": "Recurso não encontrado",
"code": "RESOURCE_NOT_FOUND"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 404
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Faixas de desconto
Atualizar faixa de desconto
PATCH
/
api
/
v1
/
discount-ranges
/
{discountRangeId}
Atualizar faixa de desconto
curl --request PATCH \
--url https://apiv3.usecorvex.com.br/api/v1/discount-ranges/{discountRangeId} \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Store-Id: <x-store-id>' \
--data '
{
"name": "Progressivo no carrinho",
"ruleType": "CART_VALUE",
"appliesToAllProducts": true,
"applyDiscountTo": "ENTIRE_CART",
"itemRangeStart": null,
"itemRangeEnd": null,
"itemRangeOrderBy": null,
"startAt": null,
"endAt": null,
"active": true,
"priority": 1,
"tiers": [
{
"minValue": 100,
"maxValue": null,
"minQuantity": null,
"maxQuantity": null,
"discountType": "PERCENT",
"discountAmount": 10,
"position": 1
}
],
"productIds": []
}
'const options = {
method: 'PATCH',
headers: {
'X-Store-Id': '<x-store-id>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({
name: 'Progressivo no carrinho',
ruleType: 'CART_VALUE',
appliesToAllProducts: true,
applyDiscountTo: 'ENTIRE_CART',
itemRangeStart: null,
itemRangeEnd: null,
itemRangeOrderBy: null,
startAt: null,
endAt: null,
active: true,
priority: 1,
tiers: [
{
minValue: 100,
maxValue: null,
minQuantity: null,
maxQuantity: null,
discountType: 'PERCENT',
discountAmount: 10,
position: 1
}
],
productIds: []
})
};
fetch('https://apiv3.usecorvex.com.br/api/v1/discount-ranges/{discountRangeId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://apiv3.usecorvex.com.br/api/v1/discount-ranges/{discountRangeId}"
payload = {
"name": "Progressivo no carrinho",
"ruleType": "CART_VALUE",
"appliesToAllProducts": True,
"applyDiscountTo": "ENTIRE_CART",
"itemRangeStart": None,
"itemRangeEnd": None,
"itemRangeOrderBy": None,
"startAt": None,
"endAt": None,
"active": True,
"priority": 1,
"tiers": [
{
"minValue": 100,
"maxValue": None,
"minQuantity": None,
"maxQuantity": None,
"discountType": "PERCENT",
"discountAmount": 10,
"position": 1
}
],
"productIds": []
}
headers = {
"X-Store-Id": "<x-store-id>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text){
"success": true,
"data": {
"discountRange": {
"id": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
"storeId": "11111111-1111-4111-8111-111111111111",
"name": "Progressivo no carrinho",
"ruleType": "CART_VALUE",
"appliesToAllProducts": true,
"applyDiscountTo": "ENTIRE_CART",
"itemRangeStart": null,
"itemRangeEnd": null,
"itemRangeOrderBy": null,
"startAt": null,
"endAt": null,
"active": false,
"priority": 1,
"tiers": [
{
"id": "dddddddd-dddd-4ddd-8ddd-dddddddddddd",
"minValue": 100,
"maxValue": null,
"minQuantity": null,
"maxQuantity": null,
"discountType": "PERCENT",
"discountAmount": 10,
"position": 1
}
],
"productIds": [],
"createdAt": "2026-09-24T14:00:00.000Z",
"updatedAt": "2026-09-24T14:00:00.000Z"
}
}
}{
"success": false,
"error": {
"message": "X-Store-Id deve ser um UUID válido",
"code": "VALIDATION_ERROR"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 400
}
}{
"success": false,
"error": {
"message": "Esta rota exige uma API Key. Use Authorization: Bearer cvx_live_...",
"code": "AUTH_API_KEY_REQUIRED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 401
}
}{
"success": false,
"error": {
"message": "Sua API Key não tem o escopo necessário para esta operação.",
"code": "AUTH_SCOPE_DENIED"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 403
}
}{
"success": false,
"error": {
"message": "Recurso não encontrado",
"code": "RESOURCE_NOT_FOUND"
},
"meta": {
"timestamp": "2026-09-24T14:00:00.000Z",
"status": 404
}
}{
"success": false,
"message": "Muitas requisições. Tente novamente em instantes.",
"error": "RATE_LIMITED",
"retryAfter": 12
}Authorizations
API Key no formato cvx_live_..., criada no painel Corvex. Não use JWT de sessão nem x-api-key.
Headers
UUID da loja. A chave precisa ter esta loja autorizada.
Path Parameters
UUID da faixa de desconto.
Body
application/json
Required string length:
2 - 150CART_VALUE usa minValue/maxValue nas faixas. QUANTITY usa minQuantity/maxQuantity.
Available options:
CART_VALUE, QUANTITY false exige productIds.
Available options:
ENTIRE_CART, LOWEST_VALUE_ITEM, HIGHEST_VALUE_ITEM, ITEM_RANGE Obrigatório se applyDiscountTo é ITEM_RANGE.
Required range:
x >= 1Obrigatório se applyDiscountTo é ITEM_RANGE.
Required range:
x >= 1Obrigatório se applyDiscountTo é ITEM_RANGE.
Available options:
CHEAPEST_FIRST, MOST_EXPENSIVE_FIRST Required range:
x >= 0Minimum array length:
1Show child attributes
Show child attributes
Produtos alvo quando appliesToAllProducts é false.
Response
Sucesso.