Endpoints

Endpoint:
/Coupons

Crie e gerencie cupons de desconto por percentual ou valor fixo, com escopo por evento ou tipo de ingresso.

Última AtualizaçãoMAR 2026
POST/v1/coupons

Criar cupom

Cria um novo cupom de desconto.

Parâmetros

CampoTipoObrigatórioDescrição
codestringOBRIGATÓRIOCódigo uppercase (mín 3 chars)
discount_typestringOBRIGATÓRIOpercentage ou fixed
discount_valueintegerOBRIGATÓRIO% (1-100) ou centavos
max_usesintegerOpcionalMáx usos (-1 = ilimitado)
valid_fromdatetimeOpcionalInício da validade
valid_untildatetimeOpcionalFim da validade
scopestringOpcionalevent (todos) ou ticket_type (específicos)
{
  "code": "VERAO2026",
  "discount_type": "percentage",
  "discount_value": 20,
  "max_uses": 100,
  "valid_from": "2026-01-01T00:00:00Z",
  "valid_until": "2026-07-15T00:00:00Z"
}
Resposta
201 Created
{
  "data": {
    "id": "coupon_uuid",
    "code": "VERAO2026",
    "discount_type": "percentage",
    "discount_value": 20,
    "uses": 0,
    "max_uses": 100
  }
}
POST/v1/coupons/validate

Validar cupom

Calcula o desconto de um cupom para um tipo de ingresso e valor específicos.

Parâmetros

CampoTipoObrigatórioDescrição
codestringOBRIGATÓRIOCódigo do cupom
ticket_type_iduuidOBRIGATÓRIOID do tipo
amountintegerOBRIGATÓRIOValor em centavos
{
  "code": "VERAO2026",
  "ticket_type_id": "tt_uuid",
  "amount": 10000
}
Resposta
200 OK
{
  "data": {
    "original_amount": 10000,
    "discount_amount": 2000,
    "final_amount": 8000
  }
}
GET/v1/coupons

Listar cupons

Retorna todos os cupons da organização.

curl .../coupons -H "Authorization: Bearer TOKEN"
Resposta
200 OK
{ "data": [...] }
DELETE/v1/coupons/:id

Deletar cupom

Remove um cupom.

curl -X DELETE .../coupons/coupon_uuid -H "Authorization: Bearer TOKEN"
Resposta
200 OK
{ "message": "Coupon deleted" }

Pronto para escalar?

Nossa infraestrutura global processa milhões de requisições simultâneas em horários de pico. Junte-se a +500 promotores usando Flair.

99.9%

Uptime Garantido

API
terminalAPI Sandbox
api.flair.api.br
Flair