Assinaturas

Checkouts de assinatura e lista de assinaturas (pending → active após o pagamento).

Criar checkout dispara checkout.created e subscription.created. Pagamento confirma com subscription.activated.

Listar assinaturas

Lista assinaturas da conta (status, cliente, valor).

GET/api/subscriptions

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

Exemplo de resposta

{ "subscriptions": [ /* Subscription[] */ ] }

Criar checkout de assinatura

Cria link /pay + subscription_checkout + assinatura pendente.

POST/api/subscription-checkouts

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

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`productId`	string	sim	Produto
`customerId`	string	sim	Cliente
`amount`	number	não	Valor (default do produto)
`paymentMethod`	string	sim	pix \| card
`couponId`	string	não	Cupom
`successUrl`	string	não	URL pós-pagamento
`returnUrl`	string	não	URL de retorno

Exemplo de resposta

{
  "ok": true,
  "checkout": {
    "id": "uuid",
    "checkout_code": "subck_…",
    "public_url": "/pay/bill_…",
    "amount_cents": 4990,
    "status": "active"
  },
  "subscription": {
    "id": "uuid",
    "subscription_code": "sub_…",
    "status": "pending"
  },
  "publicUrl": "/pay/bill_…"
}

Listar checkouts de assinatura

Lista checkouts de assinatura criados na conta.

GET/api/subscription-checkouts

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