Endpoints

Endpoint:
/Purchase

O fluxo principal de compra. Todos os endpoints são públicos (não requerem autenticação). Reserva temporária de 10 min, PIX (R$1,99) e Cartão (5%).

Última AtualizaçãoMAR 2026

POST/v1/public/purchase

Criar compra

Inicia uma compra. Cria uma reserva temporária (10 min) e retorna a URL de pagamento. O cliente deve ser redirecionado para payment_url.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
event_id	uuid	OBRIGATÓRIO	ID do evento
ticket_type_id	uuid	OBRIGATÓRIO	ID do tipo de ingresso
quantity	integer	OBRIGATÓRIO	Quantidade (1-20)
coupon_code	string	Opcional	Código do cupom
customer.name	string	OBRIGATÓRIO	Nome
customer.email	string	OBRIGATÓRIO	Email
customer.phone	string	OBRIGATÓRIO	Telefone
customer.tax_id	string	OBRIGATÓRIO	CPF

A reserva expira em 10 minutos. Após isso, o estoque é liberado automaticamente.

{
  "event_id": "event_uuid",
  "ticket_type_id": "tt_uuid",
  "quantity": 2,
  "coupon_code": "FLAIR10",
  "customer": {
    "name": "Maria Santos",
    "email": "maria@email.com",
    "phone": "11999999999",
    "tax_id": "123.456.789-00"
  }
}

Resposta

201 Created

{
  "data": {
    "reservation_id": "res_uuid",
    "charge_id": "charge_uuid",
    "payment_url": "https://pay.abacatepay.com/...",
    "total_amount": 10398,
    "expires_at": "2026-07-15T18:10:00Z"
  }
}

GET/v1/public/purchase/:id/status

Consultar status da compra

Verifica o status atual de uma compra. Status possíveis: reserved, confirmed, expired, cancelled.

curl .../public/purchase/res_uuid/status

Resposta

200 OK

{
  "data": {
    "reservation_id": "res_uuid",
    "status": "confirmed",
    "total_amount": 10398,
    "tickets_ready": true
  }
}

GET/v1/public/purchase/:id/tickets?email=...

Obter ingressos da compra

Retorna os ingressos gerados após confirmação do pagamento. Inclui QR code para check-in.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
email	string	OBRIGATÓRIO	Email do comprador (validação)

curl ".../public/purchase/res_uuid/tickets?email=maria@email.com"

Resposta

200 OK

{
  "data": [
    {
      "id": "ticket_uuid",
      "ticket_type": "Pista",
      "event_name": "Festival de Verão 2026",
      "qr_code_data": "ticket_uuid:hmac_hash",
      "status": "valid",
      "customer_name": "Maria Santos"
    }
  ]
}

GET/v1/public/tickets/:id/pdf?email=...

Baixar PDF do ingresso

Retorna o PDF do ingresso com QR code. Content-Type: application/pdf.

Parâmetros

Campo	Tipo	Obrigatório	Descrição
email	string	OBRIGATÓRIO	Email do comprador

curl -o ingresso.pdf ".../public/tickets/ticket_uuid/pdf?email=maria@email.com"

Resposta

200 OK

// Retorna arquivo PDF binário
// Content-Type: application/pdf

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

Headers