Cupons — Referência

Cupons

Cupons de desconto (fixo ou percentual) aplicáveis no checkout.

Criar cupom

Cria cupom ativo na conta.

POST/api/coupons

Autenticação: sessão do dashboard (cookie Supabase)

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`code`	string	sim	Código (uppercase)
`discountType`	string	sim	fixed \| percent
`discountValue`	number	sim	Valor (centavos se fixed, % se percent)
`maxUses`	number	não	Limite de usos

Exemplo de body

{
  "code": "PROMO10",
  "discountType": "percent",
  "discountValue": 10,
  "maxUses": 100
}

Exemplo de resposta

{
  "ok": true,
  "coupon": {
    "id": "uuid",
    "code": "PROMO10",
    "discount_type": "percent",
    "discount_value": 10,
    "max_uses": 100,
    "redeemed_count": 0,
    "status": "active"
  }
}

Listar cupons

Lista cupons; marca expired se passou expires_at.

GET/api/coupons

Autenticação: sessão do dashboard (cookie Supabase)

Exemplo de resposta

{ "coupons": [ /* Coupon[] */ ] }

Atualizar / remover

PATCH status/campos; DELETE remove o cupom.

PATCH/api/coupons/{id}

Autenticação: sessão do dashboard (cookie Supabase)