Faturamento para assinaturas em uma plataforma SaaS multitenant

Temos um produto SaaS multitenant e superamos o simples checkout único com o qual começamos. Agora precisamos de um motor de faturamento de assinatura recorrente completo, onde cada inquilino é uma conta separada com seu próprio plano de tarifas, seu próprio ciclo de faturamento e seu próprio histórico de faturas. Este não é um projeto sobre cupons e descontos e não uma página de pagamento padrão. A essência da tarefa é o ciclo de vida da assinatura ao longo do tempo: um cliente escolhe um plano, muda entre níveis, adiciona ou remove assentos, é cobrado conforme o cronograma e, às vezes, o pagamento falha, o que precisamos recuperar cuidadosamente. Queremos que todo esse fluxo seja modelado de forma limpa, e adicionar novos planos depois não deve exigir reescrever a lógica de faturamento.

Especificamente, o sistema deve suportar múltiplos planos e níveis (mensais e anuais), testes gratuitos com conversão automática para assinatura paga e contabilidade de uso para inquilinos que excedem sua cota incluída. Em um upgrade no meio do ciclo, precisamos de proporcionalidade correta — tanto crédito pela parte não utilizada do plano antigo quanto cobrança pelo novo. Cobranças falhadas devem acionar uma sequência de cobrança personalizável com tentativas e lembretes até que a assinatura seja suspensa, e cada evento de faturamento deve gerar uma fatura clara com itens, impostos e o ciclo aplicado. Tudo é estritamente isolado por inquilino: nenhuma conta deve ver os dados de outra.

Por favor, proponha um modelo de dados claro e integração com um provedor de pagamento de sua escolha para cobranças com cartão e webhooks. Para nós, o manuseio idempotente de callbacks do provedor, um registro auditado de todas as cobranças e créditos e ferramentas administrativas para visualizar e editar a assinatura de um inquilino são importantes. Em sua resposta, diga-nos como você já fez proporcionalidade e cobrança antes.

— Planos de tarifas e níveis com ciclos mensais/anuais e upgrade no meio do ciclo
— Contabilidade de uso com cotas incluídas e cobranças por excesso
— Proporcionalidade em upgrades, downgrades e mudanças na contagem de assentos
— Testes gratuitos com conversão automática para pagamento
— Cobrança: tentativas, lembretes e suspensão em caso de pagamento falhado
— Faturas com itens e impostos, além de um registro por inquilino
— Isolamento estrito de inquilinos e webhooks de pagamento idempotentes