Endpoints

Endpoint:
/Transfers

Permita que compradores transfiram ingressos para outras pessoas. Transferências expiram em 72h.

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

Iniciar transferência

Inicia a transferência de um ingresso. Gera um token único que o destinatário usa para aceitar.

Parâmetros

CampoTipoObrigatórioDescrição
to_emailstringOBRIGATÓRIOEmail do destinatário
to_namestringOBRIGATÓRIONome do destinatário
messagestringOpcionalMensagem pessoal
{
  "to_email": "amigo@email.com",
  "to_name": "Carlos Souza",
  "message": "Te vejo no festival!"
}
Resposta
201 Created
{
  "data": {
    "id": "transfer_uuid",
    "transfer_token": "a1b2c3d4e5f6...",
    "status": "pending",
    "expires_at": "2026-07-12T18:00:00Z"
  }
}
POST/v1/transfers/:token/accept

Aceitar transferência

Endpoint público (sem auth). Aceita a transferência usando o token. O QR Code é regenerado e a propriedade transferida.

curl -X POST .../transfers/a1b2c3d4e5f6.../accept
Resposta
200 OK
{
  "data": {
    "status": "completed",
    "new_ticket_id": "new_ticket_uuid"
  }
}
POST/v1/transfers/:id/cancel

Cancelar transferência

Cancela uma transferência pendente. O ingresso volta ao dono original.

Parâmetros

CampoTipoObrigatórioDescrição
reasonstringOpcionalMotivo
{
  "reason": "Mudança de planos"
}
Resposta
200 OK
{ "data": { "status": "cancelled" } }

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