Saques — Referência

Saques

Liquidação do saldo da conta para chave PIX. Exige 2FA ativo e código TOTP em cada saque.

Eventos: withdrawal.requested, withdrawal.paid, withdrawal.failed.

Criar saque

Solicita saque. speed: standard (agendado) ou instant.

POST/api/withdrawals

Autenticação: sessão do dashboard + 2FA (TOTP)

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`amount`	number	sim	Valor em reais
`pixKey`	string	sim	Chave PIX de destino
`totpCode`	string	sim	Código 2FA 6 dígitos
`speed`	string	não	standard \| instant
`kind`	string	não	standard \| advance

Exemplo de body

{
  "amount": 500,
  "pixKey": "maria@email.com",
  "totpCode": "123456",
  "speed": "standard"
}

Exemplo de resposta

{
  "ok": true,
  "withdrawal": {
    "id": "uuid",
    "withdrawal_code": "wd_…",
    "amount_cents": 50000,
    "fee_cents": 0,
    "status": "processing",
    "speed": "standard"
  }
}

Listar saques

Histórico de saques da conta + saldo disponível.

GET/api/withdrawals

Autenticação: sessão do dashboard (cookie Supabase)

Exemplo de resposta

{
  "withdrawals": [ /* Withdrawal[] */ ],
  "balance": { "available_cents": 120000 }
}