Se um grupo de planos tem mais de uma variante (por exemplo, "Standard" a R$ 300/mês e "Premium" a R$ 450/mês), um cliente pode mudar entre elas a qualquer momento — não precisa cancelar o plano atual e comprar de novo. Você também pode mudar a variante de um cliente por ele, pela administração. No app, o botão que faz isso se chama Mudar variante. Este artigo explica exatamente o que acontece dependendo de para qual variante você está mudando.
Quem pode mudar a variante
O cliente, no próprio perfil. Ele encontra um botão Mudar variante nos detalhes do plano.
O estúdio, pela administração. Abra os detalhes do plano do cliente e você verá o mesmo botão Mudar variante. Diferente do cliente, você também vê as variantes arquivadas e ocultas na lista, então pode mover um cliente para uma variante que não está mais na oferta pública.
Quatro tipos de mudança — cada um se comporta de forma diferente
O que uma mudança faz depende de que tipo de mudança ela é. São quatro cenários:
Tipo de mudança | Exemplo | O que acontece hoje |
Upgrade (mesmo intervalo, preço maior) | Mensal Standard R$ 300 → Mensal Premium R$ 450 | O cliente é cobrado pela diferença proporcional dos dias restantes, na hora. O ciclo de cobrança não muda. |
Redução agendada (mesmo intervalo, preço menor) | Mensal Premium R$ 450 → Mensal Standard R$ 300 | Nada é cobrado hoje. A mudança se aplica automaticamente na próxima renovação regular. O cliente continua pagando o preço antigo até o fim do período atual. |
Mudança de intervalo (duração de período diferente) | Mensal R$ 450 → Anual R$ 4.500 | O ciclo reinicia, o Stripe cobra o preço cheio do novo período imediatamente, e um novo ciclo começa hoje. |
Mesmo preço (variante diferente, mesmo valor) | Mensal "Pro v1" R$ 375 → Mensal "Pro v2" R$ 375 | A mudança acontece imediatamente, sem pagamento. O ciclo continua o mesmo. |
Detalhes abaixo.
Quando uma mudança é possível
O plano atual precisa estar Ativo (raramente também Aguardando início, embora na versão atual isso praticamente nunca se aplique a planos recorrentes — eles começam assim que são pagos; esse status se aplica principalmente a planos únicos).
O plano não pode estar em processo de cancelamento. Se o cliente clicou em "Cancelar no final do período", ele precisa reverter isso primeiro (clicar em Manter plano) antes de poder mudar.
O plano não pode estar pausado, não pago ou no estado "Aguardando pagamento" (uma verificação 3D Secure inacabada).
Pelo menos 24 horas precisam se passar entre mudanças de variante. O relógio começa na última mudança feita pelo cliente ou pelo estúdio — e simplesmente agendar uma mudança também conta (Cenário B). Se um cliente tentar antes, ele verá "Você só pode mudar a variante uma vez a cada 24 horas. Tente novamente mais tarde." Atenção a um mal-entendido comum: cancelar uma mudança agendada não tem limite de tempo (você pode cancelá-la quando quiser), mas uma nova mudança depois disso só é possível 24 horas após a última mudança — e o agendamento original conta para isso. Por outro lado, a aplicação automática de uma redução agendada na renovação praticamente nunca atrapalha, porque o agendamento normalmente já tem mais de 24 horas a essa altura.
A variante de destino precisa estar no mesmo grupo. Você não consegue mudar entre grupos — para mover um cliente para outro grupo, ele precisa cancelar o plano atual e comprar um novo.
A variante de destino precisa usar a mesma moeda que a atual. Se a variante de destino estiver em outra moeda (as variantes do mesmo grupo normalmente compartilham uma moeda, mas em casos raros podem diferir), o Zenamu recusa a mudança com "Este plano não pode ser alterado no estado atual. A troca de variante só está disponível para planos ativos." O motivo é técnico: a moeda de um plano recorrente existente não pode ser alterada. A única saída é cancelar o plano antigo e comprar um novo na moeda de destino.
Cada cenário em detalhe
Cenário A — Upgrade (mesmo intervalo, preço maior)
Exemplo: Um cliente paga R$ 300/mês pelo "Standard" e está no 15.º dia de um período de 30 dias. Ele muda para o "Premium" a R$ 450/mês.
O que acontece:
O Stripe cria uma fatura com dois itens: um crédito pela parte não usada do Standard (−R$ 150 por 15 dias de R$ 300) e o valor proporcional por 15 dias do Premium (+R$ 225 de R$ 450). Valor líquido a pagar: R$ 75.
O Stripe cobra os R$ 75 imediatamente no cartão do cliente. Nenhum saldo de crédito fica na conta do cliente — o crédito é usado diretamente nesta fatura.
O ciclo de cobrança NÃO muda. O próximo pagamento regular (os R$ 450 cheios) passa na data original, seguindo o cronograma original em vez de um mês após a mudança.
Durante a mudança, o cliente vê todo o detalhamento: a variante atual, a nova variante, a diferença proporcional a pagar hoje e a data do próximo pagamento regular.
Por que só a diferença proporcional e não o novo preço cheio? O cliente já pagou pelo período atual, então não há motivo para cobrar o novo preço de novo. O ciclo simplesmente continua na data original — o cliente não sente que "reiniciou" o período e tem que pagar o valor cheio de novo na hora.
E se o pagamento não puder ser feito na hora? Se o banco do cliente recusar (saldo insuficiente, cartão expirado, 3D Secure exigido), o Stripe não confirma o pagamento e a mudança não acontece. O cliente vê um erro genérico dizendo que o pagamento não pôde ser concluído — sem o motivo específico do banco. Você pode consultar o motivo no Stripe Dashboard (na fatura ou na assinatura correspondente). O cliente então precisa corrigir o cartão (via Gerenciar método de pagamento no perfil — veja Como o cliente compra um plano recorrente) e começar a mudança de novo. Esse rigor é proposital: se o Zenamu mudasse a variante mas o Stripe não confirmasse o pagamento, a cobrança ficaria uma bagunça. (O Stripe é configurado para que ele mesmo reverta toda a mudança quando um pagamento não é confirmado.)
Cenário B — Redução agendada (mesmo intervalo, preço menor)
Exemplo: Um cliente paga R$ 450/mês pelo "Premium" e está no 15.º dia de um período de 30 dias. Ele muda para o "Standard" a R$ 300/mês.
O que acontece:
Nada é cobrado na hora. Sem pagamento hoje, sem crédito.
O cliente continua pagando R$ 450 pelos 15 dias restantes do período atual (já pago, ainda usando o Premium).
Na próxima data de renovação, o Zenamu muda automaticamente a variante para Standard e o Stripe cobra R$ 300 (não R$ 450).
Tanto o cliente quanto o estúdio veem um aviso sobre a mudança agendada nos detalhes do plano, junto com a data em que ela tem efeito.
O cliente pode cancelar a mudança agendada (veja abaixo) antes dessa data e voltar para o Premium.
Por que nenhum crédito? O cliente pagou o preço cheio (mais alto) pelo período atual, então tem algo para usar. Em vez de o Stripe devolver a diferença como um crédito que depois teria que ser aplicado nos meses seguintes, ele simplesmente espera até a próxima renovação e cobra o novo preço (menor). É mais claro para o cliente assim.
Cenário C — Mudar o intervalo de cobrança
Exemplo: Um cliente paga R$ 450 por mês e está no 15.º dia de um período de 30 dias. Ele muda para a variante anual a R$ 4.500.
O que acontece:
O Stripe reinicia o ciclo de cobrança a partir de hoje.
Ele cria uma única fatura de R$ 4.500 (a tarifa anual) menos um crédito proporcional pelos 15 dias não usados do mês original (cerca de −R$ 225). O cliente é cobrado de fato por cerca de R$ 4.275 (o valor líquido). Se o novo valor for maior que o crédito pelo restante não usado do período antigo, o crédito é aplicado diretamente nesta fatura — nenhum saldo fica. Se, em vez disso, o crédito for maior (normalmente ao mudar de anual para mensal), o crédito restante fica na conta do cliente e é aplicado em renovações futuras (veja o parágrafo seguinte).
O cliente continua pagando anualmente a partir de agora; a próxima renovação é daqui a um ano.
O mesmo princípio vale na direção contrária (anual → mensal): o ciclo reinicia, e a fatura líquida é igual ao novo preço menos o crédito proporcional pela parte não usada do intervalo anterior. Se o cliente mudar logo depois de um pagamento anual, o crédito pode ser considerável — não necessariamente "pequeno".
Por que o ciclo reinicia neste caso: O cliente quis explicitamente um intervalo diferente (por exemplo, mudar para anual por um preço melhor). Reiniciar o ciclo está de acordo com o que o cliente espera.
Mesma limitação do upgrade: Se o banco do cliente recusar o pagamento ou exigir 3D Secure, a mudança não acontece. O cliente atualiza o cartão primeiro e depois confirma a mudança de novo.
Cenário D — Mesmo preço, variante diferente
Exemplo: Um cliente paga R$ 375/mês pelo "Pro v1" e muda para o "Pro v2" pelos mesmos R$ 375/mês.
O que acontece:
A variante muda imediatamente.
Sem pagamento, sem crédito.
O ciclo continua o mesmo: o próximo pagamento é na mesma data, pelo mesmo valor.
Na prática, isso só é usado de vez em quando, por exemplo depois de renomear uma variante ou fazer uma pequena mudança cosmética.
A pré-visualização detalhada antes de você confirmar
Antes de o cliente (ou o estúdio) clicar no botão Mudar variante para confirmar (a confirmação dentro da janela), ele vê uma pré-visualização item a item na janela. O que ela mostra depende do tipo de mudança:
Upgrade: "Você será cobrado em R$ 75 hoje (a diferença proporcional). O próximo pagamento regular de R$ 450 é em 15 de maio de 2026 (a data original)."
Redução agendada: "Nada é cobrado hoje. A variante muda para Standard em 15 de maio de 2026 (a data do próximo pagamento). A partir daí você pagará R$ 300/mês."
Mudança de intervalo: "Você será cobrado em R$ 4.275 hoje (R$ 4.500 menos um crédito de R$ 225 pelos 15 dias não usados). O novo ciclo anual começa hoje — o próximo pagamento de R$ 4.500 é daqui a um ano."
Mesmo preço: "A variante muda na hora, sem nova cobrança."
Se o cliente tem um saldo de crédito (que pode surgir, por exemplo, após um reembolso emitido como crédito em vez de para o cartão): o valor da pré-visualização já o leva em conta. Então, se a pré-visualização mostra "Você será cobrado em R$ 50 hoje", o cliente realmente paga R$ 50 — independentemente de um crédito ter sido aplicado "por baixo dos panos". O cliente não vê dois valores; ele só vê o final.
Se o Stripe não conseguir fazer o cálculo por algum motivo (uma instabilidade breve, digamos), o cliente vê "Não foi possível carregar o cálculo do pagamento. Tente novamente em instantes. Se o problema persistir, entre em contato com o fornecedor." e o botão Mudar variante fica desativado. Nesse caso, é só esperar um momento e tentar de novo.
Uma mudança agendada — como aparece nos detalhes do plano
Quando uma redução agendada (Cenário B) está em vigor, tanto o cliente quanto o estúdio veem um aviso amarelo/laranja nos detalhes do plano:
Mudança de variante agendada Sua variante será alterada para Standard em 15 de maio de 2026. Sua variante atual continua valendo até lá.
[Cancelar mudança agendada]
O botão Cancelar mudança agendada está disponível tanto para o cliente quanto para o estúdio. Uma vez confirmado, o Zenamu reverte tudo ao estado original — nenhuma mudança é aplicada, o cliente permanece na variante atual e continua pagando o mesmo preço.
Em casos raros, isto pode acontecer: Se alguém editou manualmente o preço da assinatura direto no Stripe Dashboard nesse meio-tempo, o Zenamu detecta a divergência quando você cancela a mudança agendada. O botão recusa a ação nesse caso. Abra o Stripe Dashboard a partir do perfil do cliente, confira o preço atual da assinatura e concilie-o manualmente com o que o cliente deveria ter.
Importante — como o limite de 24 horas funciona depois que você cancela uma mudança agendada: Cancelar uma mudança agendada não tem limite de tempo por si só — você pode clicar em Cancelar mudança agendada quando quiser. Mas uma nova mudança para outra variante só é possível 24 horas após a última mudança feita pelo cliente ou pelo estúdio, e o agendamento original da mudança conta para isso. Na prática, isso significa: se você agendar uma redução e depois cancelá-la na hora, ainda terá que esperar antes de poder mudar de novo. Depois de uma aplicação automática na renovação, por outro lado, o limite praticamente nunca se aplica, porque o agendamento normalmente já tem mais de 24 horas.
O que o cliente e o estúdio veem durante a mudança
Nos detalhes do plano, clique em Mudar variante.
Uma janela abre com a lista de variantes do mesmo grupo. A variante atual é marcada como "atual".
O cliente ou o estúdio escolhe a variante de destino. A janela carrega a pré-visualização detalhada descrita acima.
Uma vez confirmado (o botão Mudar variante na janela), o Zenamu mostra "Variante alterada." (nos cenários imediatos) ou "A mudança de variante foi agendada para o próximo período de faturamento." (numa redução agendada).
Depois da mudança
O cliente continua usando o plano sem interrupção — não há intervalo no acesso dele às reservas.
Os limites de reserva pertencem ao grupo, não à variante. Se o grupo está definido como máx. 4 reservas por semana, isso vale independentemente da variante.
O Zenamu registra a mudança internamente como um evento Variante alterada (a etiqueta que você verá na atividade do cliente e no Stripe). Com uma redução agendada, dois desses registros se acumulam ao longo do tempo (ambos com a etiqueta Variante alterada): um quando você agenda a mudança e outro na próxima renovação, quando a redução de fato tem efeito.
O status do plano é atualizado automaticamente no app tanto para o cliente quanto na administração — não é preciso atualizar a página.
Casos especiais
E se o grupo tiver só uma variante?
O botão Mudar variante não aparece — nem para o cliente, nem para você. Não há nada entre o que mudar. Se você quiser deixar o cliente mudar, adicione pelo menos mais uma variante ao grupo.
O estúdio muda um cliente para uma variante arquivada ou oculta
Na administração, a lista de variantes também mostra as que estão marcadas como Oculta do público ou Arquivada. Você pode mudar um cliente para elas — por exemplo, quando quer mover o cliente para uma variante mais antiga que mantém o preço. O cliente não consegue ver uma variante dessas por conta própria; só você consegue.
E se você adicionar uma nova variante ao grupo?
Os clientes existentes vão ver a nova variante na lista quando clicarem em Mudar variante. Eles podem mudar a qualquer momento — não precisam de mais nada de você.
E se você ocultar ou arquivar uma variante antiga?
Os clientes existentes permanecem nela até mudarem por conta própria (ou até você movê-los). Do ponto de vista deles, nada muda — eles continuam pagando o preço original. Ocultar ou arquivar só afeta novas compras: novos interessados não verão a variante.
Atenção — e se um cliente tem uma redução agendada e você arquiva a variante nesse meio-tempo: Arquivar não tem efeito sobre uma mudança agendada que já está em andamento. A partir do momento em que foi agendada, o Stripe tem o novo preço (menor) armazenado e vai cobrar do cliente exatamente esse valor na próxima renovação. Após uma renovação bem-sucedida, o Zenamu move o cliente para a variante arquivada localmente também (você verá a variante "arquivada" nos detalhes do plano dele) e registra a mudança internamente.
Se você quiser impedir que a redução tenha efeito, precisa cancelar a mudança agendada explicitamente para cada cliente desses antes da próxima renovação (o botão Cancelar mudança agendada nos detalhes do plano). Arquivar uma variante não é um "botão de desligar" — sua única função é impedir que novos clientes comprem a variante; não tem efeito retroativo sobre mudanças agendadas que já estão em andamento.
E se o cliente tem um saldo de crédito?
Mudar de variante não cria saldos de crédito — uma redução agendada (Cenário B) lida com as coisas de outra forma (sem crédito, só o novo preço a partir da próxima renovação). Um cliente só pode ter um saldo de crédito a partir de:
Uma mudança de intervalo (Cenário C) — um pequeno crédito pela parte não usada do período original.
Operações manuais no Stripe (por exemplo, o estúdio reembolsou um pagamento como crédito em vez de para o cartão).
Se um saldo de crédito existir, ele é aplicado automaticamente a uma das próximas transações. Para os detalhes, veja o artigo 12 — Reembolsos e pagamentos contestados.
E se um cliente mudar logo antes do fim do período de cobrança?
Com um upgrade, a diferença proporcional dos dias restantes é pequena (digamos, R$ 10 pelos 2 últimos dias), então a cobrança imediata é baixa. O cliente vê esse valor na janela antes de confirmar.
Com uma redução agendada, não faz diferença — ela se aplica na próxima renovação de qualquer forma.
Para o estúdio — quando intervir
Mudar a variante é, na grande maioria dos casos, uma ação do cliente. Pela administração, vale considerar nestas situações:
Um cliente pede que você o mude para uma variante específica (por exemplo, uma redução de preço combinada).
Você está arquivando uma variante antiga e quer mover os clientes para uma nova em massa (embora, mesmo assim, seja melhor falar com o cliente primeiro e deixá-lo mudar por conta própria).
Um cliente não pode ou não quer usar o perfil (uma ausência longa, digamos) e você está cuidando da conta dele manualmente.
Recomendação: Antes de mudar a variante de um cliente pela administração, sempre avise a ele com antecedência o que vai acontecer — se vamos cobrar a diferença proporcional imediatamente (um upgrade), agendar a mudança para a próxima renovação (uma redução) ou reiniciar o ciclo com um pagamento cheio (uma mudança de intervalo). O cliente deve saber da cobrança com antecedência, mesmo que o Stripe lhe envie um e-mail de confirmação automaticamente.
Perguntas frequentes
Um cliente fica mudando todo dia — por que não funciona? O limite de 24 horas evita esse tipo de experimentação. Depois da última mudança feita pelo cliente ou pelo estúdio, 24 horas precisam se passar antes que outra mudança seja possível. Agendar uma mudança também conta para esse limite (Cenário B). Se um cliente tentar antes, o Zenamu mostra "Você só pode mudar a variante uma vez a cada 24 horas. Tente novamente mais tarde." Observação: mesmo que você cancele a mudança agendada nesse meio-tempo (o que não tem limite de tempo), uma nova mudança ainda espera 24 horas a partir do agendamento original. A aplicação automática na renovação, por outro lado, praticamente nunca atrapalha, porque o agendamento normalmente já tem mais de 24 horas.
Posso criar um "pacote" para um cliente com 3 variantes diferentes de uma vez? Não — um cliente só pode ter uma variante ativa num grupo. Se você quiser vários direitos simultâneos, crie vários grupos (o cliente pode então ter uma variante de cada grupo).
Um cliente mudou a variante por engano — ele só queria comparar preços. Como desfaço?
Se foi um upgrade: voltar para a variante original (mais barata) cai no Cenário B — redução agendada. O cliente precisa esperar 24 horas e começar a mudança de volta; a mudança então só se aplica na próxima data de renovação (ele paga o preço mais alto até lá). Não há reembolso imediato.
Se foi uma mudança de intervalo: voltar cai de novo no Cenário C — mudança de intervalo (o ciclo reinicia, o Stripe calcula o ajuste proporcional). O cliente pode fazer isso depois do limite de 24 horas.
Se foi uma redução agendada: o cliente pode clicar imediatamente em Cancelar mudança agendada nos detalhes do plano e voltar ao estado original. Sem espera, sem pagamento.
Um cliente me diz que o Stripe cobrou o valor cheio depois de uma mudança de variante — isso está certo? Não, a menos que tenha sido uma mudança de intervalo. Com um upgrade (mesmo intervalo, preço maior), só a diferença proporcional dos dias restantes deveria ser cobrada, não o novo preço cheio. Se o cliente relatar qualquer outra coisa, confira a fatura específica no Stripe Dashboard a partir do perfil dele — você verá o detalhamento exato dos itens (crédito pelos dias não usados + o novo valor proporcional). O Stripe só cobra o novo preço cheio numa mudança de intervalo.
Quando exatamente uma redução agendada tem efeito? Na próxima data de renovação, conforme o ciclo atual. Se o ciclo de um cliente é no dia 15 do mês e ele agendou uma redução em 5 de maio, a mudança se aplica em 15 de maio (a renovação seguinte). Ele vê a data no aviso nos detalhes do plano.
Posso agendar uma redução para qualquer data futura que eu quiser? Não — uma redução agendada sempre tem efeito na data da próxima renovação regular. Você não pode definir uma data própria.
Artigos relacionados
Gerenciar membros existentes — todas as outras ações que você pode tomar em um plano
Mudar o preço para membros existentes — quando você quer mudar o preço de uma variante inteira, em vez de mudar um cliente específico
Códigos de desconto e planos recorrentes — os descontos não são reaplicados quando uma variante é trocada
Quando um pagamento falha — o que acontece se um pagamento falha numa renovação agendada