Como pausar subscrições no Paddle Billing

Alguns clientes não querem sair; querem uma pausa. Um negócio sazonal, um projeto em espera, um trimestre apertado. Se cancelar for a única opção, escolhem-na, e trazê-los de volta mais tarde custa um novo checkout e muitas vezes um desconto. Uma pausa mantém a subscrição, o registo do cliente e o método de pagamento, e dá-lhes um caminho fácil de regresso.

O Paddle Billing suporta a pausa de forma nativa, através da API e das cancellation flows do Paddle Retain. Este guia explica como funciona, o que acontece na retoma e como oferecê-la bem. Baseia-se na documentação do Paddle: pause a subscription, a referência da API pause subscription, subscription pause or resume, o webhook subscription.paused, as entradas do changelog sobre opções de faturação na retoma e pausar subscrições em atraso, e Cancellation Flows (todos consultados em novembro de 2026).

Como funciona uma pausa no Paddle

Pausa uma subscrição com a operação pause subscription. As principais opções:

Campo	O que faz
`effective_from`	`next_billing_period` ou `immediately`. Para subscrições ativas, o valor por omissão é `next_billing_period`.
`resume_at`	Data e hora opcionais (RFC 3339) em que a subscrição deve ser retomada sozinha
`on_resume`	Como funciona a faturação quando a subscrição é retomada (veja abaixo)

No próximo período de faturação (por omissão)

Pausar no próximo período de faturação é a opção suave. O guia de pausa do Paddle explica que cria uma alteração agendada na subscrição indicando que deve pausar na próxima data de faturação. Até lá, a subscrição continua ativa e o cliente mantém aquilo por que pagou.

Verá a alteração agendada através de subscription.updated, e subscription.paused quando a pausa produzir efeito, como descrito em subscription pause or resume.

De imediato

Com immediately, a subscrição pausa já. Use-o quando o cliente pede explicitamente para parar já, ou quando a sua própria lógica o exige (por exemplo, após um pagamento falhado).

A retoma

Uma subscrição pausada pode ser retomada de duas formas: automaticamente em resume_at, se o definir, ou quando chama a operação de retoma.

O que o cliente paga na retoma é controlado por on_resume, acrescentado no changelog de 2024 do Paddle:

start_new_billing_period (por omissão): começa um novo período de faturação e o Paddle cobra de imediato.
continue_billing_period: a subscrição mantém o período de faturação existente. O Paddle devolve um erro se combinar isto com uma data de retoma posterior ao fim desse período.

Para a maioria das pausas de retenção, o valor por omissão é mais fácil de explicar aos clientes: “o seu plano recomeça a [data] e será cobrado nessa altura”. Use continue_billing_period para pausas curtas dentro de um período que o cliente já pagou.

Subscrições em atraso

A pausa interage com os pagamentos falhados de formas que vale a pena conhecer:

A documentação do Paddle diz que, enquanto uma subscrição está past_due, ainda a pode pausar ou cancelar, embora a maioria das outras atualizações esteja bloqueada.
O changelog de 2024 do Paddle diz que, quando pausa uma subscrição, as transações de renovação em atraso são canceladas automaticamente, para evitar cobrar períodos de faturação sobrepostos. Quando a subscrição pausada é retomada, começa um novo ciclo de faturação.
O Paddle devolve um erro se tentar continuar o período de faturação existente numa subscrição em atraso. Use antes start_new_billing_period.

Isso torna a pausa um estado final razoável também para os pagamentos falhados. O artigo de ajuda do Paddle sobre a cadência de novas tentativas diz que pode escolher pausar, cancelar ou deixar em atraso uma subscrição quando termina a janela de recuperação.

Pausar e cancelar

Um pormenor na documentação das Cancellation Flows do Paddle: se um cliente cancelar uma subscrição ativa, o cancelamento fica agendado para o próximo período de faturação, mas uma subscrição pausada é cancelada de imediato. Diga-o aos clientes na confirmação da pausa, para que “pausar e cancelar mais tarde” não os surpreenda.

Oferecer uma pausa com o Paddle Retain

As Cancellation Flows do Paddle Retain fazem um inquérito curto quando um cliente tenta cancelar e depois apresentam uma oferta para ficar. A documentação do Paddle inclui a pausa entre as opções de salvamento, agendada para o próximo período de faturação, a par das mudanças de plano e de um desconto temporário quando o cliente recusa a primeira oferta. As escolhas de cancelar, pausar e fazer downgrade passam para o Paddle Billing.

Desde janeiro de 2026, o changelog do Paddle diz que as Cancellation Flows aparecem também quando os clientes cancelam no customer portal do Paddle e a partir dos links de cancelamento nos emails de subscrição do Paddle. Sem um fluxo configurado, os clientes veem um simples diálogo de confirmação. Uma entrada posterior do changelog acrescenta que os fluxos podem ser construídos e testados em sandbox através do customer portal.

Nas regiões com regras de cancelamento num clique, o changelog de 2024 do Paddle diz que aparece um link de cancelamento em todos os ecrãs do fluxo. O Paddle deteta essas regiões automaticamente.

Como oferecer bem uma pausa

Adeque a oferta ao motivo. Uma pausa responde a motivos temporários: sazonalidade, um projeto parado, viagens, um ciclo orçamental. Não responde a “demasiado caro” nem a “faltam funcionalidades”. Veja pausa vs desconto como ofertas de retenção.
Ofereça durações fixas. Um, dois ou três meses, com resume_at definido. As pausas sem fim tendem a tornar-se cancelamentos silenciosos.
Diga o que acontece na retoma. A data, o montante e se começa um novo período de faturação.
Envie um lembrete antes da retoma. Envie um email alguns dias antes de resume_at com um link para prolongar ou cancelar. Uma cobrança inesperada após uma pausa é uma fonte clássica de pedidos de reembolso.
Mantenha o cancelamento a um clique. A pausa é uma oferta, nunca uma barreira. Veja regras de click to cancel.

Ligá-la à sua app

Em subscription.updated com uma pausa agendada, mostre a data da pausa na página da conta.
Em subscription.paused, passe a conta para um estado pausado e decida que dados ficam visíveis.
Na retoma, reponha o acesso e registe-o.
Nos relatórios, conte os clientes pausados à parte. Uma pausa não é churn, mas uma pausa que termina em cancelamento deve manter o motivo original.

Checklist de testes

Uma pausa no próximo período de faturação mantém o acesso até essa data.
Uma pausa imediata corta o acesso de imediato.
resume_at retoma a subscrição e cobra como esperado para a sua escolha de on_resume.
Pausar uma subscrição em atraso cancela a renovação em atraso.
Cancelar uma subscrição pausada termina-a de imediato, e a sua app trata disso.

Fazer isto com o NoChurn

O fluxo de cancelamento do NoChurn pede um motivo e, com base nele, oferece uma pausa, um desconto ou uma mudança de plano, com o cancelamento num clique sempre visível. Funciona alojado ou em headless através da API, por isso adapta-se a apps em que não usa o portal do Paddle. A subscrição propriamente dita fica no Paddle, que continua a ser o merchant of record. Os motivos de cancelamento alimentam depois os emails de reconquista aos dias 30, 60 e 90 e o score de churn. Veja NoChurn + Paddle.