core/billing-finance-core/docs/billing-flow.md

Fluxo de cobrança

1. Criação de plano
   • Define preço, ciclo de cobrança e limites.
2. Assinatura
   • Relaciona tenant e plano, define datas de ciclo e status.
3. Invoice
   • Conta a receber com vencimento e status.
4. Pagamento
   • Gateway escolhido gera pagamento (Pix, boleto, cartão).
5. Webhook
   • Gateway envia evento de pagamento.
6. Conciliação
   • Atualiza status do pagamento e invoice.

Status principais

• Invoice: PENDING, PAID, OVERDUE, CANCELED
• Payment: PENDING, CONFIRMED, FAILED, CANCELED