Upgrade, downgrade e cancelamento de assinatura no Explory (Stripe)
Contratar um plano, subir de tier ou cancelar no fim do ciclo deve ser simples — e seguro. No Explory, toda a jornada de billing passa pelo painel e pela Stripe, sem que você precise informar preços ou IDs sensíveis manualmente.
Este guia mostra como funciona cada operação em /panel/subscription/manage e o que esperar após cada mudança.
Onde gerenciar sua assinatura
Acesse Assinatura → Gerenciar (/panel/subscription/manage) pelo menu lateral. Nessa tela você encontra:
- Plano atual e status da assinatura
- Data de renovação ou cancelamento programado
- Tabela comparativa de planos (Basic, Profissional, Empresarial)
- Botões para contratar, alterar plano, abrir portal de pagamento e cancelar
O painel sincroniza o perfil ao retornar do Stripe — se você atualizou cartão ou fatura no portal, volte à aba do Explory para ver o status atualizado.
Primeira contratação (Trial → plano pago)
Se você está no Plano Gratuito, a ação disponível é Contratar ou Assinar. Ao escolher um plano pago na tabela:
- O frontend envia apenas o
targetPlanCode(ex.:PROFESSIONAL) para a API. - Você é redirecionado ao Stripe Checkout para pagamento seguro.
- Após confirmação, o webhook Stripe atualiza plano, créditos e permissões no backend.
- A página de sucesso (
/panel/subscription/success) orienta o retorno ao painel.
Importante: o estado da assinatura não muda só pela URL de sucesso — a confirmação oficial vem do webhook. Aguarde alguns segundos e atualize o perfil se necessário.
Upgrade: efeito imediato com proration
Upgrade acontece quando você escolhe um plano de tier superior (ex.: Basic → Profissional). Nesse caso:
- A mudança é aplicada imediatamente
- A Stripe calcula proration — cobrança proporcional pelo restante do período
- Créditos e permissões do novo plano entram em vigor após confirmação
No painel, o botão aparece como Fazer upgrade ou Alterar plano, dependendo do contexto. Se houver alteração pendente, a interface pode bloquear ações conflitantes até a mudança anterior ser processada.
Downgrade: agendado para a próxima fatura
Downgrade (tier inferior, ex.: Profissional → Basic) não corta o acesso na hora. A solicitação fica agendada para o vencimento do período atual:
- Você mantém créditos e permissões do plano atual até a data de renovação
- O painel exibe aviso de alteração pendente com o plano destino
- Na virada do ciclo, o novo tier passa a valer
Isso evita perda imediata de recursos que você já pagou no mês corrente.
Cancelamento: volta ao Trial no fim do período
Cancelar a assinatura também é programado para o fim do período (cancelAtPeriodEnd):
- Clique em Cancelar assinatura na gestão.
- Confirme no diálogo — a assinatura permanece ativa até a data exibida.
- Depois do término, você retorna ao Plano Gratuito (TRIAL) com as regras correspondentes.
Enquanto o cancelamento estiver agendado, o tour do painel pode sugerir Reativar plano para evitar interrupção de créditos recorrentes.
Portal de pagamento Stripe
Usuários com assinatura paga podem abrir o Portal do Cliente Stripe direto do painel. Lá é possível:
- Atualizar cartão de crédito
- Baixar faturas
- Revisar histórico de cobrança
Se o pagamento falhar, o status pode aparecer como PAST_DUE. Nesse caso, regularize pelo portal para evitar bloqueio de execuções (SUBSCRIPTION_INACTIVE).
Boas práticas
- Faça upgrade antes de projetos com alto volume de pesquisas.
- Agende downgrade ou cancelamento com antecedência — não no último dia de um lançamento.
- Confira créditos e permissões em Perfil após qualquer mudança de plano.
Próximo passo
Billing transparente libera você para focar em marketplace e concorrência, não em planilhas de cobrança. Gerencie tudo pelo painel e deixe a Stripe cuidar do pagamento.