Skip to main content
PUT
Atualizar cupom

Authorizations

Authorization
string
header
required

Token JWT obtido em /auth/login, enviado no cabeçalho Authorization no formato Bearer <token>.

Path Parameters

id
string<uuid>
required

Body

application/json

Dados para criação de um cupom de desconto.

code
string
required

Código do cupom.

Example:

"BEMVINDO10"

type
string
required

Tipo do desconto (ex. percentual ou valor fixo).

Example:

"percent"

value
number<double>
required

Valor do desconto (percentual ou em reais, conforme o tipo).

Example:

10

description
string
Example:

"Cupom de boas-vindas"

max_uses
integer

Número máximo de utilizações do cupom.

Example:

100

expires_at
string<date-time>
Example:

"2026-12-31T23:59:59Z"

is_active
boolean

false desativa o cupom: ele é recusado no checkout e no /coupons/validate, sem apagar o histórico. É a alternativa à exclusão quando o cupom tem referências demais (ver o 409 do DELETE). Só tem efeito na atualização (PUT); na criação todo cupom nasce ativo.

Example:

false

Response

Cupom atualizado com sucesso.

data
object

Objeto representando um cupom de desconto.