Como pausar subscrições no Recurly

Uma pausa é muitas vezes a oferta certa para um cliente que quer cancelar porque não vai usar o produto durante algum tempo: ele mantém a conta e o seu negócio mantém o cliente. O Recurly suporta a pausa de forma nativa, mas com um conjunto de regras fáceis de ignorar, sobretudo em planos anuais e com cupões. Este guia explica como funciona a pausa no Recurly Subscriptions e como oferecê-la bem.

Baseia-se apenas na documentação do próprio Recurly: pause subscription, pause subscriptions: things to consider, o guia de gestão de subscrições, as notificações de subscrição, o guia de webhooks do ciclo de vida da subscrição e a visão geral dos webhooks (todos consultados em novembro de 2026). O Recurly Commerce, um produto separado, tem as suas próprias definições de pausa; este guia trata do Recurly Subscriptions.

Como funciona uma pausa

A pausa faz-se através do endpoint Pause Subscription com remaining_pause_cycles, o número de ciclos de faturação a saltar (pause subscription). Os exemplos do Recurly usam 10, o que congela a faturação durante dez ciclos. O mecanismo:

1. Começa na próxima data de faturação. O Recurly não suporta pausas a meio do ciclo. O cliente mantém o período que já pagou.
2. Cada renovação saltada desconta um ciclo. Em cada data de faturação durante a pausa, remaining_pause_cycles diminui uma unidade e o Recurly envia uma notificação de renovação saltada.
3. Termina sozinha. Quando a contagem chega a zero, a subscrição é retomada: o Recurly inicia um novo ciclo de faturação e gera uma fatura de imediato, cobrada no meio de pagamento guardado se a cobrança for automática.
4. Pode terminá-la mais cedo. Os administradores podem retomar a partir da página da subscrição ou da conta, e a API tem um endpoint de retoma. Retomar mais cedo também inicia um novo ciclo de faturação com uma fatura imediata.

Não existe uma definição separada de “pausa por tempo indeterminado”. As notas sobre a pausa do próprio Recurly referem que alguns comerciantes definem antes um número de ciclos muito alto. A documentação que encontrámos não indica um máximo.

O que não pode ser pausado

A página de considerações do Recurly enumera os limites:

Situação	O que diz o Recurly
Subscrições em trial, canceladas, expiradas ou falhadas	Não podem ser pausadas; só as subscrições ativas podem
Cliente em recuperação de pagamento ou com faturas em atraso	Resolva isso primeiro
Uma pausa já agendada ou em curso	Pausas simultâneas não são suportadas; uma tem de terminar primeiro
Alteração imediata da subscrição durante uma pausa	Cancela a pausa
Add-ons por utilização	A utilização registada antes da pausa é faturada na data da pausa; não é possível registar utilização durante a pausa

As duas últimas contam na prática. Se um agente de suporte fizer um upgrade a um cliente em pausa, ou se a sua app fizer uma alteração imediata, a pausa desaparece. E se fatura por utilização, verifique que nada no seu produto regista utilização em contas pausadas.

Planos anuais: adiar em vez de pausar

Uma pausa salta ciclos de faturação inteiros. Num plano anual, um ciclo é um ano. O exemplo do Recurly: um cliente a meio de um plano anual (seis meses) pede uma pausa de um mês; pausar um ciclo agenda uma pausa de um ano inteiro a partir da próxima renovação anual.

Para pausas curtas em planos anuais, o Recurly recomenda adiar a próxima data de faturação, com o endpoint Modify (update) Subscription. Isso prolonga o período atual em vez de saltar um ano.

Os cupões continuam a contar

O Recurly diz que os cupões não são pausados com a subscrição: a sua duração continua a correr durante a pausa. Se reteve um cliente com “50% de desconto durante três meses” e ele depois pausa durante três meses, o desconto pode esgotar-se antes de voltar a ser faturado. Ofereça o desconto depois da pausa, ou escolha uma das ofertas, não as duas.

Outros efeitos secundários

• Datas do prazo. O Recurly indica que as datas de renovação do prazo não são atualizadas durante uma pausa.
• Relatórios. As subscrições em pausa contam como ativas nas análises do Recurly, mas não acrescentam MRR, já que não geram faturas. Acompanhe-as à parte quando analisar a retenção.
• Regiões com SCA. As páginas do Recurly aconselham, nas regiões com SCA, retomar através da API com a devida autenticação do cliente em vez de o fazer a partir da Admin Console. As duas páginas que o referem não descrevem o problema da mesma forma, por isso teste a retoma na sua região antes de contar com ela.

Quem pode pausar

A documentação do Recurly diz que os clientes não podem pausar nem retomar a sua própria subscrição a partir do Hosted Account Management. Essa página mostra o estado em pausa, mas a pausa em si tem de vir:

• da sua equipa de suporte, na Admin Console;
• da sua própria app ou página de conta, através dos endpoints de pausa e retoma, que é a única opção self-service no Recurly Subscriptions;
• do Recurly Commerce, cujo Customer Portal tem um botão de pausa, se vender através desse produto.

Se quer que a pausa faça parte de um fluxo de cancelamento, tem de construir esse passo ou usar uma ferramenta que o faça.

Webhooks

O Recurly envia notificações para cada etapa de uma pausa (notificações de subscrição): uma pausa agendada, uma pausa modificada, uma pausa cancelada (os campos da pausa voltam a null), a subscrição pausada, cada renovação saltada e a subscrição retomada, enviada quando passa de pausada a ativa com um novo ciclo de faturação.

As páginas do Recurly dão nomes diferentes a estes eventos. A referência das notificações usa títulos como “Scheduled subscription pause” e “Subscription pause canceled”, o guia do ciclo de vida usa identificadores como pause.scheduled e renewal.skipped, e outra página usa subscription.paused e subscription.resumed. Verifique os nomes nos payloads que a sua conta recebe de facto. O Recurly diz também que os webhooks se configuram na Admin Console, não pela API, que deve confirmar o estado através da API antes de atualizar os seus sistemas, e que o seu endpoint tem de aceitar duplicados e eventos fora de ordem.

Oferecer bem uma pausa

1. Ofereça-a pelo motivo certo. “Não vou usar durante algum tempo”, “negócio sazonal”, “orçamento congelado até ao próximo trimestre”. É uma má resposta para “o produto não faz o que preciso”.
2. Verifique primeiro a elegibilidade. Mostre a oferta apenas a subscrições ativas, fora do trial, que não estejam em recuperação de pagamento e sem pausa agendada.
3. Escolha a ferramenta certa para o plano. Ciclos de pausa para planos mensais; adiar a próxima data de faturação para pausas curtas em planos anuais.
4. Diga exatamente o que acontece. “A sua subscrição fica em pausa a partir de 12 de dezembro durante 2 meses. Voltará a ser faturado a 12 de fevereiro.” Leia as datas na resposta do Recurly.
5. Avise antes de a faturação recomeçar. A retoma cria uma fatura de imediato. Envie um lembrete alguns dias antes, com um link para cancelar se o cliente já não precisar do produto.
6. Mantenha o cancelamento visível. Uma oferta de pausa fica ao lado de “Cancel now”, nunca no seu lugar.
7. Acompanhe o que acontece depois. Veja quantos clientes em pausa retomam e continuam a pagar, e quantos cancelam no fim.

Fazer isto com o NoChurn

O fluxo de cancelamento do NoChurn pode oferecer uma pausa, a par de um cupão ou de uma mudança de plano, e aplica a oferta aceite à subscrição no Recurly; um cancelamento com um clique fica visível em cada passo, alojado ou em headless através da API. Segue os webhooks do Recurly, por isso os clientes que cancelam mais tarde recebem emails de reconquista aos 30, 60 e 90 dias consoante o motivo, e o score de churn de 0 a 100 tem em conta o seu histórico. A faturação, as faturas e a cobrança na retoma ficam no Recurly. O NoChurn é grátis abaixo de $300 de MRR. Veja NoChurn + Recurly.