O upgrade de assinatura permite que o seu comprador troque para um plano de maior valor dentro da assinatura ativa, sem cancelar e sem perder dias de acesso.
Ele paga só a diferença proporcional entre o plano atual e o novo, e você aumenta a receita da base que já tem.
A troca vale para um plano de valor total maior e em recorrência diferente da atual, por exemplo de Mensal para Trimestral ou de Mensal para Anual. Não há troca para um plano de menor valor nem entre planos da mesma recorrência.
Antes de começar
Para o upgrade ficar disponível, a oferta precisa ter pelo menos dois planos de recorrências diferentes. Do lado do comprador, a assinatura precisa estar ativa e em dia: sem cobranças de Pix ou boleto pendentes e com o primeiro pagamento já confirmado.
Como configurar o upgrade na sua oferta
A configuração fica no cadastro dos planos da oferta.
Cadastre os planos de recorrência. Uma oferta aceita um plano por recorrência (Mensal, Trimestral, Semestral, Anual). Ao criar um novo plano, o valor e o período precisam ser maiores que os do plano anterior.
Ligue o toggle Upgrade de plano. Ele fica no modal de criação e edição de plano, junto de Taxa de adesão. O toggle só habilita quando já existe outro plano de maior valor na oferta, e vive no plano de origem (o de menor valor).
Escolha os planos de destino. Com o toggle ligado, aparece o bloco Selecione os planos, com os destinos em checkbox. Todos vêm marcados; desmarque o que não quiser oferecer. Para deixar de oferecer upgrade neste plano, desligue o toggle em vez de desmarcar todos os destinos.
Ofertas criadas antes desta funcionalidade já vêm com o upgrade habilitado. Para uma delas passar a oferecer troca, basta criar um segundo plano de maior valor.
Como o valor da troca é calculado
O valor não utilizado do plano atual vira um crédito proporcional, que é abatido da nova cobrança.
Crédito = valor pago no ciclo atual × (dias restantes ÷ dias totais do ciclo) Nova cobrança = valor total do novo plano − crédito
Exemplo: plano atual Mensal de R$ 100,00, upgrade para Anual de R$ 960,00, no dia 15 de um ciclo de 30 dias. O crédito é 100 × (15 ÷ 30) = R$ 50,00, e a nova cobrança é 960 − 50 = R$ 910,00.
A taxa de adesão não entra nesse cálculo e não é cobrada de novo na troca. O ciclo reinicia na data da cobrança do upgrade, e essa data define a próxima renovação. O acesso ao produto não é comprometido continua liberado quando o pagamento é confirmado: cartão na hora, Pix normalmente no mesmo dia e boleto após a compensação.
As formas de pagamento aceitas são cartão, pix e boleto.
Como oferecer o upgrade
Na aba Assinaturas, clique em uma assinatura para abrir os detalhes e use o botão Oferecer Upgrade.
No modal, você tem duas opções: copiar o link do checkout para compartilhar no canal que quiser, ou enviar um convite por e-mail para o comprador daquela assinatura. O convite mostra o plano atual e os planos disponíveis para upgrade e leva ao checkout com os planos já filtrados.
Como o comprador faz a troca
O link abre o checkout já com os planos elegíveis daquela assinatura. O plano atual não aparece como destino. Quando há mais de um plano elegível, o comprador escolhe no campo Escolha seu plano; com um único, o plano aparece fixo. Em seguida ele confirma o pagamento e a assinatura sobe de plano.
Ofereça o Upgrade de forma automática no seu Funil
Lendo os eventos de Webhook, você irá receber os links de upgrade de cada plano para poder oferecer a troca de plano para o comprador diretamente no seu funil, sem precisar de ação manual.
Isso permite que você crie estratégias e funis com os links de upgrade da forma que mais performe para seu produto.
Acompanhar pelo webhook
A troca chega no mesmo evento Recurrent_Payment usado nas renovações. Três informações identificam e explicam a cobrança de troca:
PlanUpgrade(dentro dePurchase): presente só quando a cobrança vem de uma troca. TrazCurrentPlan(plano de origem),NewPlan(plano de destino) eProRatedCredit(o crédito aplicado). A presença desse objeto é o que distingue a troca de uma renovação comum.
PlanUpgradeUrl: o link pronto do checkout de upgrade daquela assinatura. Vem preenchido quando a assinatura está elegível enullquando não está. Ele já chega desde a primeira compra (Purchase_Order_Confirmed), então você pega o link direto do webhook e usa no seu funil quando quiser, sem entrar na plataforma para enviar o convite manual. A cada abertura, o checkout revalida a elegibilidade.
NextBilling: a próxima data de cobrança, já recalculada para o novo ciclo.
No valor, Price traz o valor cobrado (novo plano menos o crédito) e OriginalPrice traz o valor cheio do novo plano.
Exemplo do trecho relevante em uma troca de Mensal (R$ 5,00) para Trimestral (R$ 10,00), com crédito de R$ 4,83:
"Purchase": { "OriginalPrice": { "Value": 10.00 }, "Price": { "Value": 5.17 }, "NextBilling": "2026-12-21T00:00:00", "PlanUpgrade": { "CurrentPlan": { "Name": "Mensal", "Amount": 5.00 }, "NewPlan": { "Name": "Trimestral", "Amount": 10.00 }, "ProRatedCredit": 4.83 } }, "Subscriptions": [ { "PlanUpgradeUrl": "https://lastlink.com/p/{codigo-da-oferta}?subscriptionId={id-da-assinatura}" } ]Onde a troca aparece nos relatórios
Toda cobrança gerada por uma troca aparece como Upgrade de assinatura nos seus relatórios. No relatório de assinaturas, a assinatura passa a exibir o plano novo, com o histórico dos planos anteriores preservado, e a próxima data de renovação é recalculada a partir do novo plano. O histórico da assinatura registra a cobrança do upgrade, com data, valor pago e link para a venda.
No relatório de Vendas, as vendas da assinatura original e do upgrade ficam separadas.
