Links de pagamento

Links genéricos com página pública /pay/bill_…. Sessão do dashboard. Dispara webhook checkout.created.

Criar link

Cria link vinculado a um produto da conta.

POST/api/payment-links

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

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`productId`	string	sim	UUID do produto
`productName`	string	não	Título opcional do link
`amount`	number	sim	Valor em reais
`paymentMethod`	string	sim	pix \| card
`couponId`	string	não	Cupom opcional
`successUrl`	string	não	URL pós-pagamento
`returnUrl`	string	não	URL de retorno

Exemplo de body

{
  "productId": "uuid-produto",
  "amount": 99.9,
  "paymentMethod": "pix",
  "successUrl": "https://seusite.com/obrigado"
}

Exemplo de resposta

{
  "ok": true,
  "link": {
    "id": "uuid",
    "link_code": "bill_…",
    "title": "Plano Pro",
    "amount_cents": 9990,
    "payment_method": "pix",
    "status": "active",
    "created_at": "…"
  }
}

Listar links

Lista apenas links genéricos (link_source = link). Cobranças e assinaturas ficam em outras abas.

GET/api/payment-links

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

Exemplo de resposta

{ "links": [ /* PaymentLink[] */ ] }

Atualizar link

Atualiza status (active/inactive), URLs ou metadados do link.

PATCH/api/payment-links/{id}

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

Remover link

Remove o link de pagamento da conta.

DELETE/api/payment-links/{id}

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