Planos e Assinatura
Planos e Assinatura
Resumo
O módulo de Planos e Assinaturas (arquivos em app/Admin/Views/settings/plans/ e app/User/Controllers/SubscriptionController.php) controla o ciclo de vida comercial: escolha de plano, ativação, mudança, cancelamento e reativação. O admin cadastra planos e features em /admin/settings/plans, e o usuário os consome em /dashboard/plans e /dashboard/subscriptions.
Para quem é (personas)
- Usuário final que contrata, muda ou cancela assinatura.
- Admin de produto que define planos, features e trials.
- Revendedor (tenant) que cria planos próprios com sua marca.
O que você pode fazer
Visualizar Planos (/dashboard/plans)
- Listar planos disponíveis com preço, features e CTA.
- Comparar features (plans.php / features.php no admin).
Gerenciar Assinaturas (/dashboard/subscriptions)
- Contratar:
POST /api/subscriptions/subscribe. - Cancelar:
POST /api/subscriptions/cancel(pode ser ao fim do ciclo). - Reativar:
POST /api/subscriptions/reactivate. - Mudar de plano:
POST /api/subscriptions/change-plan(upgrade/downgrade).
Administração (/admin/settings/plans/)
- Planos (
plans.php) — criar/editar planos e preços. - Features (
features.php) — cadastrar features e vincular a planos. - Assinaturas (
subscriptions.php) — ver todas as assinaturas do tenant. - Trials (
trials.php) — configurar períodos de teste.
Cupons e Descontos
- Criação de cupons em
/admin/settings/users/coupons. - Validação no checkout via
/api/checkout/validate-coupon.
Como acessar
Contratar plano
- Acesse
/dashboard/plans. - Clique em Contratar no plano desejado.
- É redirecionado para
/dashboard/checkout. - Finalize o pagamento.
Ver minha assinatura
- Acesse
/dashboard/subscriptions(ou tab Financeiro → Assinaturas). - Veja plano atual, próxima cobrança, histórico.
Tutoriais
Fazer upgrade de plano
Objetivo: Migrar para um plano superior.
Passos:
- Em
/dashboard/subscriptions, clique em Mudar plano. - Selecione o novo plano.
- Confirme valor proporcional (pro-rata) exibido.
- Finalize (
/api/subscriptions/change-plan).
Cancelar assinatura
Objetivo: Encerrar cobrança recorrente.
Passos:
- Em
/dashboard/subscriptions, clique em Cancelar. - Informe o motivo (coleta de feedback).
- Confirme — serviço permanece ativo até o fim do período pago.
Reativar assinatura cancelada
Objetivo: Voltar ao plano antes do fim do ciclo.
Passos:
- Em
/dashboard/subscriptions, clique em Reativar. - Confirme — a cobrança recorrente é retomada (
/api/subscriptions/reactivate).
Integrações
- Billing: todas as mudanças geram faturas via
/admin/settings/billing/invoices. - Dunning: falhas de cobrança disparam fluxo automatizado.
- Event Bus: eventos
invoice.created,invoice.paid,invoice.overdue. - Workspace: plano pode liberar serviços e quotas no plugin Workspace.
Perguntas frequentes
Posso testar antes de pagar? Sim, se o admin habilitou trial (/admin/settings/plans/trials.php).
Se eu cancelar, perco os dados? Não imediatamente. O plano fica ativo até o fim do período pago. Após isso, o serviço é suspenso mas os dados permanecem por período de retenção configurado.
Como funciona o upgrade no meio do mês? Cobrança proporcional (pro-rata) — você paga só a diferença pelos dias restantes.
E o downgrade? Muda no próximo ciclo (não gera crédito imediato).
Tenho mais de uma assinatura? Sim, é possível quando o modelo de negócio admite (módulos avulsos, multi-serviço).
Por que minha assinatura está como "pendente"? Aguardando confirmação de pagamento (boleto, PIX). Verifique /dashboard/payments.
Posso cancelar sem aviso ao admin? Sim, o cancelamento é self-service. O admin recebe notificação.
O cupom serve para renovações? Depende da configuração do cupom (uma vez, recorrente, percentual fixo, etc.).
Limitações e políticas
- Cancelamento respeita política comercial configurada no tenant.
- Reembolso segue política do tenant (não automático).
- Pro-rata calculado em dias corridos.
- Isolamento multi-tenant — cada tenant tem seus planos.
Relacionados
- Pagamentos e Billing
- Workspace e Serviços Contratados
- Carteira e Transações
- Suporte e Tickets
Este artigo foi útil?
Perguntas e Respostas
Nenhuma pergunta ainda. Seja o primeiro a perguntar!