Como pausar subscrições no Lemon Squeezy

Um cliente que quer uma pausa não é o mesmo que um cliente que quer sair. Se o único botão que encontra é “Cancelar”, perde ambos. O Lemon Squeezy tem uma funcionalidade de pausa nativa, e é mais flexível do que muitas equipas julgam: dois modos de pausa, uma data opcional de retoma automática e suporte completo na API.

Este guia explica como funciona a pausa no Lemon Squeezy, como acioná-la a partir do painel, do portal do cliente ou da API, e como oferecê-la no momento certo. Limita-se à documentação do próprio Lemon Squeezy: a referência Update a Subscription, a referência do objeto Subscription, o guia de gestão de subscrições, a página Customer Portal e os tipos de eventos de webhook (todos consultados em novembro de 2026).

Os dois modos de pausa

O Lemon Squeezy pausa uma subscrição definindo nela um objeto pause. O objeto tem um mode, e a referência Update a Subscription documenta dois valores:

Modo	Para que serve segundo o Lemon Squeezy	O que o cliente recebe
void	Quando não pode prestar o seu serviço durante um período (o exemplo dado é a manutenção): as faturas são anuladas para que os clientes não sejam cobrados	Sem cobrança e, por consequência, sem serviço
free	Oferecer a subscrição gratuitamente enquanto a cobrança está suspensa	Sem cobrança, e serviço continuado

Ambos os modos param a cobrança. A diferença está no que promete em troca, e isso é uma decisão de produto, não de faturação. O Lemon Squeezy não gere o acesso por si: é a sua app que decide o que um cliente em pausa pode fazer.

Na prática:

• void é a “pausa” habitual que um cliente pede. Não vai usar o produto durante algum tempo, e não paga por ele.
• free é um gesto comercial. Use-o quando quer que um cliente continue a usar o produto sem o cobrar, por exemplo enquanto resolve um problema que o afetou.

Pausar com uma data de retoma

O objeto pause aceita também um resumes_at opcional, uma data e hora ISO 8601. Quando está definido, a subscrição volta a cobrar a partir dessa data. Sem ele, a pausa dura até alguém a retirar.

A documentação que usámos não indica uma duração máxima de pausa. Se quiser uma, imponha-a na sua própria interface enviando sempre um resumes_at.

Retirar a pausa

Para terminar uma pausa, define pause como null na subscrição. Segundo a referência Update a Subscription, a subscrição volta então a active e a cobrança é retomada no calendário original.

Vale a pena pensar no “calendário original”. A data de referência da faturação não muda por causa da pausa, por isso um cliente que retoma pode ser cobrado na sua data habitual de renovação em vez de no dia em que volta. Se isso o puder surpreender, diga-o no ecrã onde retoma.

Três formas de pausar

1. A partir do painel

O guia de gestão de subscrições descreve o caminho manual: no painel do Lemon Squeezy, vá a Store e depois Subscriptions, selecione a subscrição e clique em “Pause Subscription”. Útil para pedidos de suporte.

2. A partir do portal do cliente

O Customer Portal alojado do Lemon Squeezy permite aos subscritores pausar e retomar, cancelar e reativar, e mudar de produto. Escolhe as funcionalidades que o portal mostra nas definições de design. Se depende do portal, verifique que a pausa está ativada e visível ao lado do cancelamento.

3. A partir da API

Para pausar a partir da sua própria app, envie um PATCH para o endpoint da subscrição com um objeto pause, como mostra a referência Update a Subscription. Um corpo de pedido mínimo, no formato JSON:API:

{
  "data": {
    "type": "subscriptions",
    "id": "123",
    "attributes": {
      "pause": {
        "mode": "void",
        "resumes_at": "2027-02-01T00:00:00.000000Z"
      }
    }
  }
}

Para retirar a pausa, envie o mesmo pedido com "pause": null.

O que muda na subscrição

Segundo a referência do objeto Subscription:

• Uma subscrição em pausa tem o estado paused.
• O atributo pause guarda o modo e resumes_at durante a pausa, e é null caso contrário.

A página de tipos de eventos lista dois eventos dedicados, subscription_paused e subscription_unpaused. O Lemon Squeezy envia também subscription_updated em cada alteração, por isso, se já trata esse evento e lê status, a pausa não exige nenhum webhook adicional.

Como oferecer bem uma pausa

O Lemon Squeezy dá-lhe a mecânica. Se os clientes escolhem realmente uma pausa depende de como a oferece.

Ofereça-a no momento do cancelamento

O momento de maior intenção é quando o cliente clica em “Cancelar”. Se a sua app envia os clientes diretamente para o portal, eles veem a pausa como uma opção entre várias. Se construir a sua própria página de cancelamento, pode perguntar primeiro porque se vão embora e depois oferecer uma pausa aos clientes cujo motivo encaixa: “vou fazer uma pausa”, “sazonal”, “não o uso neste momento”, “orçamento deste mês”.

Mantenha a opção de cancelar visível nessa página. Uma oferta de pausa deve ser uma alternativa genuína, não um muro. Esconder o cancelamento gera tickets de suporte e chargebacks, e em vários países está regulado.

Torne a pausa concreta

“Pausar a sua subscrição” é vago. “Pausar 1, 2 ou 3 meses, sem cobrança, os seus dados ficam aqui” é uma decisão que alguém toma em cinco segundos. Associe cada escolha a um resumes_at e envie-o com o pedido.

Avise antes de terminar

Uma pausa que retoma a cobrança em silêncio parece uma armadilha. Programe um lembrete alguns dias antes de resumes_at: “A sua pausa termina a 1 de março. Será cobrado na sua data habitual. Quer prolongar ou cancelar?” A documentação do Lemon Squeezy que usámos não descreve um lembrete nativo para isto, por isso envie-o a partir da sua própria ferramenta de email.

Escolha o modo de propósito

Para uma pausa pedida pelo cliente, use void. Reserve free para quando decide continuar a servir um cliente sem custo. Trocá-los significa cobrar por nada ou oferecer um serviço que queria pausar.

Meça

Conte os eventos subscription_paused e o que acontece a seguir a cada cliente em pausa: retomou e renovou, cancelou durante a pausa, ou cancelou logo a seguir a retomar. Isso diz-lhe se as ofertas de pausa salvam clientes ou só adiam o cancelamento.

Uma checklist antes de lançar

1. A pausa está ativada no portal do cliente, ou a sua própria página de cancelamento oferece-a.
2. A sua app associa paused a uma regra de acesso (sem acesso para void, acesso normal para free).
3. Cada pausa feita a partir da sua interface envia um resumes_at.
4. Sai um lembrete antes de a pausa terminar.
5. O seu handler de webhooks atualiza os seus registos em subscription_paused, subscription_unpaused ou subscription_updated.
6. Testou o caminho completo em modo de teste com eventos de webhook simulados.

Fazer isto com a NoChurn

A pausa em si continua a ser uma funcionalidade do Lemon Squeezy; a NoChurn usa-a em vez de a substituir. A NoChurn acrescenta um fluxo de cancelamento à frente do botão de cancelar: o cliente indica um motivo, vê uma oferta adequada (uma pausa, um desconto ou uma mudança de plano) e pode sempre cancelar com um clique. O fluxo é alojado, ou headless através da API se o quiser totalmente com o seu próprio design. As respostas alimentam o churn score e os emails de reconquista enviados aos dias 30, 60 e 90. Veja NoChurn + Lemon Squeezy.