Endpoints

Endpoint:
/Tickets

Validação de ingressos no check-in via QR code, reembolso e consulta. Todos os endpoints requerem autenticação Bearer.

Última AtualizaçãoMAR 2026
POST/v1/tickets/:id/validate

Validar ingresso (check-in)

Valida um ingresso via QR code. Marca como 'used' se válido. Retorna motivo se inválido.

Parâmetros

CampoTipoObrigatórioDescrição
qr_codestringOBRIGATÓRIODados do QR code (ticket_uuid:hmac_hash)
validator_idstringOpcionalID do validador/porteiro
{
  "qr_code": "ticket_uuid:hmac_hash",
  "validator_id": "porteiro_01"
}
Resposta
200 OK
{
  "data": {
    "valid": true,
    "ticket": {
      "id": "ticket_uuid",
      "status": "used",
      "customer_name": "Maria Santos"
    }
  }
}
POST/v1/tickets/:id/refund

Reembolsar ingresso

Processa o reembolso de um ingresso. O estoque é restaurado automaticamente e o cliente é notificado por email.

Parâmetros

CampoTipoObrigatórioDescrição
reasonstringOBRIGATÓRIOMotivo do reembolso
{
  "reason": "Solicitação do cliente"
}
Resposta
200 OK
{
  "data": {
    "id": "ticket_uuid",
    "status": "refunded",
    "refund_amount": 5199
  }
}
GET/v1/tickets/:id

Obter ingresso

Retorna detalhes completos de um ingresso.

curl .../tickets/ticket_uuid -H "Authorization: Bearer TOKEN"
Resposta
200 OK
{
  "data": {
    "id": "ticket_uuid",
    "ticket_type": "Pista",
    "status": "valid",
    "customer_name": "Maria Santos",
    "event_name": "Festival de Verão 2026"
  }
}

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