Cobranças

Cobranças da aba do dashboard (link_source = charge): listagem, PIX rápido e checkout com cliente.

Listar cobranças

Lista checkouts de cobrança e métricas da conta.

GET/api/charges

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

Exemplo de resposta

{
  "charges": [
    {
      "id": "uuid",
      "customer_name": "Maria",
      "customer_email": "maria@email.com",
      "amount_cents": 5000,
      "payment_method": "pix",
      "status": "pending",
      "public_url": "/pay/bill_…",
      "created_at": "…"
    }
  ],
  "metrics": { /* totais */ }
}

Quick PIX

Gera cobrança PIX rápida (link + QR) para o valor informado.

POST/api/charges/quick-pix

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

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`amount`	number	sim	Valor em reais
`description`	string	não	Descrição opcional
`customerId`	string	não	Cliente cadastrado (opcional)

Exemplo de body

{
  "amount": 49.9,
  "description": "Cobrança avulsa"
}

Checkout de cobrança

Cria checkout de cobrança com cliente e método de pagamento.

POST/api/charges/checkout

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

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`customerId`	string	sim	UUID do cliente
`amount`	number	sim	Valor em reais
`paymentMethod`	string	sim	pix \| card
`title`	string	não	Título da cobrança