# Suspender cobrança de pagamentos Saiba como suspender a coleta de pagamentos de assinaturas. 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 pausar ou retomar a cobrança no[Dashboard Stripe](https://support.stripe.com/questions/how-to-pause-or-cancel-subscriptions) ou na API. Enquanto a cobrança está pausada, assinaturasainda geram faturas, mas você tem algumas opções para lidar com essas faturas. Revise os seguintes casos de uso para determinar a melhor abordagem para você: | Caso de uso | Configuração de API | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------- | | [Oferecer temporariamente serviços gratuitos e nunca cobrar pagamentos](https://docs.stripe.com/billing/subscriptions/pause-payment.md#collect-payment-never) | Usar `behavior=void` | | [Oferecer temporariamente serviços gratuitos e coletar o pagamento posteriormente](https://docs.stripe.com/billing/subscriptions/pause-payment.md#collect-payment-later) | Usar `behavior=keep_as_draft` | | [Oferecer temporariamente serviços gratuitos e marcar a fatura como incobrável](https://docs.stripe.com/billing/subscriptions/pause-payment.md#mark-as-uncollectible) | Usar `behavior=mark_uncollectible` | Se essas opções não se encaixarem no seu caso de uso, talvez seja melhor [cancelar as assinaturas](https://docs.stripe.com/billing/subscriptions/cancel.md). Faturas criadas antes da suspensão das assinaturas passam por [novas tentativas](https://docs.stripe.com/invoicing/automatic-collection.md), a menos que sejam [anuladas](https://docs.stripe.com/api/invoices/void.md). ## 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 curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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 curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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`. > Se você tiver uma lógica personalizada que finaliza faturas, pode precisar desativá-la ou modificá-la para evitar conflito com essas configurações. 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 curl https://api.stripe.com/v1/invoices/{{INVOICE_ID}} \ -u "<>:" \ -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 curl https://api.stripe.com/v1/subscriptions/{{SUBSCRIPTION_ID}} \ -u "<>:" \ -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 ```bash curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \ -u <>: \ -d "pause_collection"= ``` Retomar a coleta dessa maneira só afeta faturas futuras. ## Cronogramas de assinatura e suspensão Se você pausar uma assinatura em um [cronograma de assinatura](https://docs.stripe.com/billing/subscriptions/subscription-schedules.md), as atualizações programadas ainda entram em vigor. No entanto, o pagamento não é recolhido enquanto a assinatura estiver pausada. Quando quiser recolher o pagamento novamente, será necessário [retomar manualmente](https://docs.stripe.com/billing/subscriptions/pause-payment.md#unpausing) a assinatura. Você também precisa atualizar `auto_advance` para `true` (verdadeiro) em quaisquer faturas com `status=draft` nas quais deseja recolher o pagamento.