Billing e Monetização

Visão Geral

O Decaelo monetiza por dois eixos:

1. Assinatura SaaS — igrejas pagam mensalidade pelo uso da plataforma
2. Doações/Dízimos Online — membros contribuem pela plataforma, Decaelo recebe split automático

Gateway: Asaas (brasileiro).

---

Escolha do Gateway

Análise Comparativa

Critério	Asaas	Stripe	Mercado Pago
PIX nativo	Sim, R$0 taxa	Não nativo no Brasil	Sim, taxa 0.5%
Boleto	R$1.99/unidade	R$3.49/unidade	R$3.49/unidade
Cartão de crédito	2.99%	3.99% + R$0.39	4.99%
Sub-contas / Split	Nativo e simples	Stripe Connect (complexo, compliance)	Marketplace (burocrático)
Recorrência	Nativa via API	Nativa (Laravel Cashier)	Limitada
Sandbox gratuito	Sim	Sim	Sim
Documentação PT-BR	Excelente	Apenas inglês (qualidade boa)	Inconsistente
Laravel SDK oficial	Não (SDK PHP genérico)	Laravel Cashier oficial	Não
Prazo de saque	D+2 (PIX)	D+7+ (internacional)	D+14
Regulação brasileira	Regulado pelo BACEN	Empresa estrangeira	Regulado pelo BACEN

Prós e Contras — Asaas (escolhido)

Prós:

• PIX sem custo de taxa (essencial para igrejas brasileiras)
• Sub-contas nativas com split automático — ideal para marketplace
• Documentação em português, suporte brasileiro
• Saques rápidos (D+2 via PIX)
• API REST bem documentada e estável
• Sandbox completo para desenvolvimento
• Regulado pelo Banco Central do Brasil

Contras:

• Sem Laravel Cashier oficial (compensado pelo nosso domain Billing com Actions)
• SDK PHP genérico (sem tipagem forte — tratamos com wrapper AsaasService)
• Menos features avançadas que Stripe (analytics, fraud detection)
• Menos conhecido internacionalmente

Prós e Contras — Stripe (descartado)

Prós:

• Laravel Cashier oficial (integração madura)
• Melhor documentação técnica do mercado
• Stripe Connect para marketplaces
• Dashboard admin robusto
• Detecção de fraude nativa (Radar)

Contras:

• Taxa mais alta (3.99% + R$0.39 vs 2.99%)
• PIX não nativo no Brasil
• Stripe Connect é complexo para sub-contas brasileiras
• Empresa estrangeira — compliance e suporte mais distante
• Saques internacionais demoram (D+7+)

Prós e Contras — Mercado Pago (descartado)

Prós:

• Popular no Brasil, confiança do consumidor
• PIX disponível
• Marketplace para split

Contras:

• Taxa de cartão mais alta (4.99%)
• Documentação inconsistente e com versões desatualizadas
• Prazo de saque longo (D+14)
• API de marketplace burocrática
• Suporte limitado para B2B/SaaS

Decisão

Asaas — menor custo total para o público-alvo (igrejas brasileiras), PIX sem taxa, sub-contas nativas com split automático, documentação em PT-BR, saques rápidos via PIX. A ausência de Laravel Cashier oficial é compensada pelo domain Billing com Actions seguindo o padrão arquitetural do projeto.

---

Custos Estimados

Assinatura SaaS (Decaelo cobra a igreja)

Forma de Pagamento	Taxa Asaas	Custo real (plano R$99)	Custo real (plano R$249)
PIX	R$0	Decaelo recebe R$99,00	Decaelo recebe R$249,00
Cartão de crédito	2.99%	Decaelo recebe R$96,04	Decaelo recebe R$241,55

Recomendação: Incentivar PIX (sem taxa) como forma padrão.

Doações/Dízimos (membro paga a igreja)

Forma	Taxa Asaas	Split Decaelo (3%)	Igreja recebe líquido (doação R$100)
PIX	R$0,00	R$3,00	R$97,00
Cartão de crédito	R$2,99	R$3,00	R$94,01
Boleto	R$1,99	R$3,00	R$95,01
Cartão recorrente	R$2,99	R$3,00	R$94,01

Projeção de Receita

Igreja pequena (50 membros, dízimo médio R$100):

• Volume doações: ~R$5.000/mês
• Split Decaelo: R$150/mês
• Assinatura (Semente): R$0
• Total: R$150/mês

Igreja média (200 membros, dízimo médio R$200):

• Volume doações: ~R$40.000/mês
• Split Decaelo: R$1.200/mês
• Assinatura (Crescimento): R$99/mês
• Total: R$1.299/mês

Igreja grande (500+ membros, dízimo médio R$300):

• Volume doações: ~R$150.000/mês
• Split Decaelo: R$4.500/mês
• Assinatura (Expansão): R$249/mês
• Total: R$4.749/mês

---

Arquitetura

Modelo de Dados

Model	Banco	Justificativa
Subscription	Central	Decaelo gerencia todas as assinaturas globalmente
Invoice	Central	Faturas da Decaelo — visão unificada para cobrança
DonationAccount	Central	Sub-contas Asaas precisam de referência cross-tenant
Donation	Tenant	Dados financeiros isolados por igreja (LGPD)
DonationCategory	Tenant	Categorias personalizáveis por igreja
Transaction (existente)	Tenant	Contabilidade integrada

Fluxo de Dados

Assinatura SaaS:
  Igreja → Asaas (payment) → Webhook → Invoice (central) → Subscription status

Doação/Dízimo:
  Membro → Asaas (payment + split) → Webhook → Donation (tenant) + Transaction (tenant)
                                         ↓
                                   Split → Wallet Decaelo (automático)

Segurança

• Webhook: validado por token secreto (ASAAS_WEBHOOK_TOKEN)
• API keys: apenas em .env, nunca no banco de dados
• Dados bancários: enviados direto ao Asaas via API, não armazenados no Decaelo
• CPF do doador: armazenado com encrypted cast (AES-256-CBC)
• Página pública: rate limiting throttle:30,1
• HTTPS: obrigatório em produção para todas as rotas de pagamento

Integrações

• Finance domain (existente): Doações confirmadas geram Transaction automaticamente para contabilidade da igreja
• Feature flags (existente): online_donations controla acesso ao módulo de doações por plano
• Tenant lifecycle (existente): Pipeline de inadimplência usa SuspendTenantAction já implementado
• Notifications (existente): Lembretes de pagamento via SendNotificationAction

---

Formas de Pagamento

Assinatura SaaS

Forma	Disponível	Motivo
PIX	Sim	Sem taxa, incentivado como padrão
Cartão de crédito	Sim	Conveniência, recorrência automática
Boleto	Não	Alta inadimplência + custo fixo por emissão

Doações/Dízimos

Forma	Disponível	Recorrência	Motivo
PIX	Sim	Não (manual)	Sem taxa, popular no Brasil
Cartão de crédito	Sim	Sim (automática)	Única forma com recorrência real
Boleto	Sim	Não (manual)	Acessibilidade (público idoso)

Recorrência: Apenas cartão de crédito suporta cobrança automática. PIX e boleto requerem ação manual do membro a cada mês.

---

Pipeline de Inadimplência

Dias após vencimento	Ação	Impacto	Reversível
1-3	Email de lembrete ao admin	Nenhum no sistema	N/A
4-7	Banner de aviso no sistema	Visual, sem bloqueio	Sim
8-15	Modo somente leitura	Bloqueia criação/edição	Sim
16+	Suspensão total	Login bloqueado	Sim

Pagamento a qualquer momento reverte automaticamente todas as restrições.

Dados nunca são excluídos — mesmo tenants suspensos mantêm seus dados intactos.