Skip to main content
PATCH
/
v1
/
app
/
discount
/
{discount-id}
Update Discount
curl --request PATCH \
  --url https://api.centralcart.com.br/v1/app/discount/{discount-id} \
  --header 'Content-Type: application/json' \
  --data '
{
  "coupon": "<string>",
  "applies_to": [
    123
  ],
  "type": "<string>",
  "value": 123,
  "max_uses": 123,
  "expires_in": "<string>",
  "min_price": 123,
  "limit_criteria": "<string>",
  "restricted_to_criteria": "<string>",
  "restricted_to": [
    "<string>"
  ]
}
'
{
  "id": 3361,
  "store_id": 1,
  "coupon": "50OFF",
  "type": "PERCENTAGE",
  "value": 5,
  "applies_to": [10, 11],
  "uses": 0,
  "max_uses": null,
  "expires_in": "2024-10-16T00:00:00.000-03:00",
  "min_price": null,
  "limit_criteria": null,
  "restricted_to_criteria": null,
  "restricted_to": null,
  "created_at": "2023-05-10T21:47:17.000-03:00",
  "updated_at": "2023-09-14T12:04:46.000-03:00"
}
​
discount-id
string
O ID do desconto a ser atualizado
​
coupon
string
O cupom que será atualizado. Aceita apenas letras, números, hífens e underlines.
​
applies_to
number[]
Lista de ID dos produtos em que o cupom poderá ser aplicado. Use [-1] para aplicar a todos os produtos.
​
type
string
O tipo do desconto, podendo ser PRICE ou PERCENTAGE
​
value
number
O valor do desconto
​
max_uses
number
A quantidade máxima de usos que o desconto pode ter. Envie null para remover o limite.
​
expires_in
date
A data de expiração do desconto. Envie null para remover a expiração.
​
min_price
number
Valor mínimo do pedido para que o cupom possa ser aplicado. Envie null para remover. Intervalo: 0 a 999999.
​
limit_criteria
string
Critério de limitação de uso por cliente. Quando definido, cada cliente só poderá usar o cupom uma vez com base no critério escolhido. Valores possíveis: CLIENT_IDENTIFIER, CLIENT_EMAIL, CLIENT_DISCORD. Envie null para remover.
​
restricted_to_criteria
string
Tipo de restrição para limitar o cupom a clientes específicos. Deve ser usado junto com restricted_to. Valores possíveis: CLIENT_IDENTIFIER, CLIENT_EMAIL, CLIENT_DISCORD. Envie null para remover.
​
restricted_to
string[]
Lista de identificadores dos clientes que poderão usar o cupom. Requer que restricted_to_criteria esteja definido. Envie null para remover.
{
  "id": 3361,
  "store_id": 1,
  "coupon": "50OFF",
  "type": "PERCENTAGE",
  "value": 5,
  "applies_to": [10, 11],
  "uses": 0,
  "max_uses": null,
  "expires_in": "2024-10-16T00:00:00.000-03:00",
  "min_price": null,
  "limit_criteria": null,
  "restricted_to_criteria": null,
  "restricted_to": null,
  "created_at": "2023-05-10T21:47:17.000-03:00",
  "updated_at": "2023-09-14T12:04:46.000-03:00"
}