Suspender cobrança de pagamentos

A suspensão na cobrança de pagamentos costuma ser usada para oferecer serviços gratuitos temporariamente. Às vezes, isso é chamado de “período de carência” quando um cliente precisa de mais tempo para pagar ou não consegue pagar por um ou mais períodos de cobrança.

Você pode suspender ou retomar a coleta no Stripe Dashboard ou na API. Enquanto a coleta está suspensa, as assinaturas geram faturas, mas você tem algumas opções para gerenciar essas faturas. Analise os seguintes casos de uso para determinar a melhor abordagem para você:

Se essas opções não se encaixarem no seu caso de uso, talvez seja melhor cancelar as assinaturas.

Faturas criadas antes da suspensão das assinaturas passam por novas tentativas, a menos que sejam anuladas.

Oferecer temporariamente serviços gratuitos e nunca coletar pagamentos

Se quiser oferecer seus serviços gratuitamente temporariamente e não quiser cobrar o pagamento da fatura (por exemplo, um “período de carência”), você pode anular faturas criadas pela assinatura para garantir que os clientes não sejam cobrados e que a assinatura permaneça status=active. Use o ID de assinatura para atualizar pause_collection[behavior] para void e pause_collection[resumes_at] para a data em que deseja começar a receber pagamentos novamente.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=void

Todas as faturas criadas antes da data de resumes_at são imediatamente marcadas como nulas. A Stripe não enviará nenhum e-mail sobre faturas futuras ou webhooks e o status da assinatura permanece inalterado.

Se você não definir uma data de resumes_at, a assinatura permanece suspensa até que você cancele a definição de pause_collection.

Oferecer temporariamente serviços gratuitos e coletar o pagamento posteriormente

Se quiser oferecer seus serviços de forma temporária e gratuita e cobrar pagamentos posteriormente, defina pause_collection[behavior]=keep_as_draft. Se você souber quando deseja retomar a cobrança, passe um carimbo de data e hora para resumes_at.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=keep_as_draft

Todas as faturas criadas antes da data de resumes_at permanecem em estado draft, e auto_advance é definido como false. Nesse período, a Stripe não envia nenhum e-mail sobre as próximas faturas nem webhooks para essas faturas, e o status da assinatura permanece inalterado.

Se você não definir uma data de resumes_at, a assinatura permanece suspensa até que você cancele a definição de pause_collection.

Quando estiver pronto para coletar o pagamento dessas faturas, defina auto_advance novamente como true. Se não tiver os IDs das faturas, você poderá usar os IDs de assinaturas para verificar faturas com status=draft. Usando o ID da fatura, é possível atualizar auto_advance=true:

curl https://api.stripe.com/v1/invoices/
{{INVOICE_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d auto_advance=true

Oferecer temporariamente serviços gratuitos e marcar faturas como incobráveis

Se quiser oferecer seus serviços gratuitamente e marcar as faturas geradas pela assinatura como incobráveis, use o ID da assinatura para atualizar pause_collection[behavior] para mark_uncollectible e, opcionalmente, pause_collection[resumes_at] para a data em que deseja começar a cobrar pagamentos novamente. Isso garante que todos os relatórios posteriores sejam precisos, que o cliente não seja cobrado e que a assinatura permaneça status=active.

curl https://api.stripe.com/v1/subscriptions/
{{SUBSCRIPTION_ID}} \
  -u "
sk_test_BQokikJOvBiI2HlWgH4olfQ2
:" \
  -d "pause_collection[behavior]"=mark_uncollectible

Se você definir pause_collection[behavior] como mark_uncollectible, interromperemos a cobrança ativa de pagamentos de novas faturas criadas antes da data do resumes_at. A Stripe não enviará nenhum e-mail sobre faturas futuras ou webhooks para essas faturas.

Apesar dessa pausa, a Stripe aplica todos os saldos de clientes existentes às faturas. Esse comportamento ajuda a usar os fundos disponíveis antes de marcarmos uma fatura como uncollectible. Se o total da fatura for quitado inteiramente usando o saldo do cliente, o status da fatura será definido como paid. Caso contrário, o status da fatura é definido como uncollectible.

Se você não definir uma data de resumes_at, a cobrança de pagamentos na assinatura permanece suspensa até que você cancele a definição de pause_collection.

Cancelar a suspensão manualmente

Para retomar a coleta de pagamentos a qualquer momento, atualize a assinatura e cancele a definição de pause_collection:

curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \
  -u 
sk_test_BQokikJOvBiI2HlWgH4olfQ2
: \
  -d "pause_collection"=

Retomar a coleta dessa maneira só afeta faturas futuras.

Cronogramas de assinatura e suspensão

Se você suspender uma assinatura em um cronograma de assinatura, as atualizações agendadas ainda terão efeito. No entanto, o pagamento não é cobrado enquanto a assinatura está suspensa. Para voltar a cobrar pagamentos, é preciso cancelar manualmente a suspensão da assinatura. Também é preciso atualizar auto_advance para true nas faturas com status=draft que você desejar cobrar.