API

Cupons

Endpoints para gerenciar cupons de desconto

📋 Listar Cupons

GET/guilds/{guildId}/coupons

Query Params

Prop

Type

Resposta

[
  {
    "id": "clx...",
    "reference": "DESCONTO10",
    "discount": 10,
    "valorMin": 50.00,
    "valorMax": null,
    "amount": null,
    "uses": 0,
    "status": "ACTIVED"
  }
]

🔍 Buscar Cupom

GET/guilds/{guildId}/coupons/{id}

✨ Criar Cupom

POST/guilds/{guildId}/coupons

Body

Prop

Type

Após criar o cupom, use o PATCH para definir desconto, limites e regras.

Exemplo

{
  "reference": "VERAO25",
  "createdBy": "123456789012345678"
}

✏️ Atualizar Cupom

PATCH/guilds/{guildId}/coupons/{id}

Todos os campos são opcionais.

Prop

Type


🗑️ Deletar Cupom

DELETE/guilds/{guildId}/coupons/{id}

🔢 Contar Cupons

GET/guilds/{guildId}/coupons/count
{ "count": 8 }