# Suspender cobrança de pagamentos

Saiba como suspender a coleta de pagamentos de assinaturas.

Você pode pausar a cobrança de pagamentos para oferecer temporariamente seus serviços gratuitamente a um cliente. Isso às vezes é chamado de período de carência, por exemplo, quando um cliente precisa de mais tempo para pagar ou não pode pagar por um ou mais períodos de cobrança.

Quando você pausa a cobrança de pagamentos, a *assinatura* (A Subscription represents the product details associated with the plan that your customer subscribes to. Allows you to charge the customer on a recurring basis) permanece `ativa` e as *faturas* (Invoices are statements of amounts owed by a customer. They track the status of payments from draft through paid or otherwise finalized. Subscriptions automatically generate invoices, or you can manually create a one-off invoice) continuam a ser geradas, mas a Stripe não realiza a cobrança. Seu cliente mantém o acesso ao serviço durante esse período.

## Before you begin

- Se você deseja pausar o acesso do cliente ao serviço, pausar a cobrança de pagamentos e também pausar as faturas, consulte [Pausar assinaturas](https://docs.stripe.com/billing/subscriptions/pause.md).
- Se você deseja interromper permanentemente a renovação, consulte [Cancelar assinaturas](https://docs.stripe.com/billing/subscriptions/cancel.md).
- As faturas criadas antes de você pausar as assinaturas continuam a ser [tentadas novamente](https://docs.stripe.com/invoicing/automatic-collection.md), a menos que você as [anule](https://docs.stripe.com/api/invoices/void.md).

## Pausar cobrança de pagamentos

Utilize o Dashboard ou a API para pausar a cobrança de pagamentos.

Você pode optar por pausar a cobrança de pagamentos indefinidamente ou retomar automaticamente a cobrança de pagamentos em um momento específico no futuro. Durante o período em que a cobrança de pagamentos estiver pausada, a Stripe não enviará e-mails de fatura futura nem webhooks para essas faturas, e o status da assinatura permanecerá inalterado.

Ao pausar a cobrança de pagamentos para uma assinatura, você tem três opções para tratar as faturas durante o período de pausa:

|  |
| **Manter faturas como rascunho** (`keep_as_draft`) | - As faturas são criadas com status de `rascunho` e `auto_advance` definido como falso.
- Você pode finalizá-la e cobrar o pagamento posteriormente.
  > Se você possui lógica personalizada que finaliza faturas, talvez seja necessário desativá-la ou modificá-la para que não entre em conflito com essas configurações. |
| **Marcar faturas como incobráveis** (`mark_uncollectible`) | - As faturas são marcadas como incobráveis. Nenhum pagamento é cobrado nesses períodos. A Stripe não envia e-mails de fatura futura nem webhooks para essas faturas.
- Apesar dessa pausa, a Stripe aplica qualquer saldo existente do cliente às faturas. Esse comportamento auxilia na utilização dos fundos disponíveis antes de marcarmos uma fatura como incobrável. Se o valor total da fatura for integralmente quitado utilizando o saldo do cliente, o status da fatura será definido como `paga`. Caso contrário, o status da fatura será definido como `incobrável`. |
| **Anular faturas** (`void`) | As faturas serão anuladas. Nenhum registro de cobranças será criado para esses períodos. |

Para pausar a cobrança de pagamentos para uma assinatura:

#### Dashboard

1. Na página [Assinaturas](https://dashboard.stripe.com/subscriptions), selecione a assinatura.

2. Clique no menu de opções (⋯) e selecione **Pausar cobrança de pagamentos**.

3. Escolha a duração:

   - **Indefinidamente**: mantemos a cobrança de pagamentos pausada até que você a retome.
   - **Até uma data personalizada**: retomaremos automaticamente a cobrança de pagamentos na data que você escolher.

4. Escolha o comportamento da Fatura:

   - **Mantenha as faturas como rascunhos**: as faturas são criadas como rascunhos. Você pode finalizá-las e coletar o pagamento posteriormente.
   - **Marcar faturas como incobráveis**: as faturas são marcadas como incobráveis. Nenhum pagamento é coletado nesses períodos.
   - **Faturas anuladas**: as faturas são anuladas. Nenhum registro de cobrança é criado para esses períodos.

5. Clique em **Pausar**.

#### API

Para pausar a cobrança de pagamentos de uma assinatura, [atualize a assinatura](https://docs.stripe.com/api/subscriptions/update.md) e defina `pause_collection[behavior]`. Opcionalmente, defina `pause_collection[resumes_at]` para retomar automaticamente a cobrança de pagamentos em um momento específico.

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

### pause_collection[behavior]

Escolha como lidar com as faturas criadas enquanto a cobrança de pagamentos estiver pausada:

- `keep_as_draft`: mantém todas as faturas no status de rascunho enquanto a cobrança estiver pausada.
- `mark_uncollectible`: marca todas as faturas como incobráveis enquanto a cobrança estiver pausada.
- `void`: anula todas as faturas enquanto a cobrança estiver pausada.

### pause_collection[resumes_at]

Um timestamp Unix após o qual a assinatura retoma a cobrança de pagamentos.

Se você não definir `resumes_at`, a cobrança de pagamentos permanecerá pausada até que você desfaça `pause_collection`.

> Se você pausar uma assinatura que é gerenciada por um cronograma de assinatura, as atualizações agendadas ainda entram em vigor. Uma transição de fase do agendamento de assinatura não remove automaticamente o comportamento `pause_collection` definido diretamente na assinatura.

## Retomada da cobrança de pagamentos

Você pode retomar a cobrança de pagamentos a qualquer momento usando o Dashboard ou a API para uma assinatura ou para faturas mantidas como rascunho.

### Retomar cobrança a partir de uma assinatura

#### Dashboard

Para retomar a cobrança de pagamentos no Dashboard:

1. Na página [Assinaturas](https://dashboard.stripe.com/subscriptions), localize a assinatura pertinente.
2. Clique no menu de opções (⋯) e selecione **Retomar cobrança de pagamentos**.

#### API

Para retomar a cobrança de pagamentos, [atualize a assinatura](https://docs.stripe.com/api/subscriptions/update.md) e desfaça `pause_collection`. Você pode desfazer chaves individuais enviando um valor vazio para elas:

#### curl

```bash
curl https://api.stripe.com/v1/subscriptions/sub_GTbTiykEwMRog0 \
  -u <<YOUR_SECRET_KEY>>: \
  -d "pause_collection"= 
```

### Cobrar pagamento em faturas em rascunho

Após retomar a cobrança de pagamentos de uma assinatura, defina `auto_advance=true` em cada fatura em rascunho. Caso não possua os IDs das faturas, localize-os utilizando o ID da assinatura com `status=draft` como filtro.

#### Dashboard

Após retomar a cobrança de pagamentos de uma assinatura, para cada fatura em rascunho:

1. Acesse a [página Faturas](https://dashboard.stripe.com/invoices/) no Dashboard e clique na fatura para visualizar a página de detalhes.
2. Clique no menu de opções (⋯).
3. Clique em **Ativar cobrança automática**. Isso altera a propriedade `auto_advance` da fatura para `verdadeiro`.

#### API

Recupere as faturas em rascunho da assinatura:

```curl
curl -G https://api.stripe.com/v1/invoices \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d "subscription={{SUBSCRIPTION_ID}}" \
  -d status=draft
```

Em seguida, para cada fatura em rascunho, defina `auto_advance` como `verdadeiro`:

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

## See also

- [Pausar assinaturas](https://docs.stripe.com/billing/subscriptions/pause.md)