> ## Documentation Index
> Fetch the complete documentation index at: https://docs.assiny.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cobrança que falha

> A régua de recuperação: quantas tentativas existem, o que decide a próxima data e o que encerra o ciclo

Quando uma cobrança recorrente não passa — de uma **assinatura** ou de um **parcelamento
inteligente** —, a Assiny não desiste na primeira recusa nem cancela na hora. O ciclo entra em uma
**régua de recuperação**, reavaliada todos os dias.

## Os dois limites

| Limite | Valor |
| - | - |
| **Tentativas por ciclo** | **3** — atingiu 3, o ciclo encerra |
| **Janela de recuperação** | **20 dias**, contados a partir da data de referência do ciclo |

<Warning>
  **A janela é fixada quando o ciclo abre.** Ela é um retrato: mudar a configuração depois não
  estica nem encurta uma janela que já está correndo.
</Warning>

## O motivo da recusa decide a próxima ação

A régua lê o código que o emissor do cartão devolve. Ele não serve só para registro — é ele que
escolhe entre remarcar a cobrança ou parar de tentar.

| O que o código indica | O que a régua faz |
| - | - |
| **Saldo insuficiente** | Marca uma **nova data** |
| **Bloqueio ligado à pessoa** | **Encerra o ciclo** — não é problema que outra tentativa resolva |
| Qualquer outro | Só registra; a avaliação do dia seguinte decide |

### Saldo insuficiente: como a nova data é escolhida

<Steps>
  <Step title="A régua calcula um piso" icon="calendar-day">
    A próxima tentativa nunca é hoje — no mínimo amanhã.
  </Step>

  <Step title="Procura um dia preferencial" icon="star">
    Se houver um dia **5, 15 ou 20** igual ou posterior ao piso e ainda dentro da janela, a
    cobrança é remarcada para ele.
  </Step>

  <Step title="Se nenhum couber, usa o próprio piso" icon="arrow-right">
    Desde que o piso ainda esteja dentro da janela.
  </Step>
</Steps>

Não sobrando nenhuma data possível dentro da janela, o ciclo se encerra — mesmo que ainda haja
tentativa no orçamento. É por isso que uma recusa perto do fim da janela costuma ser a última.

### Por que às vezes demora alguns dias

A recusa pode vir com uma orientação do emissor que impõe uma **espera mínima** antes de o mesmo
cartão ser apresentado de novo. Conforme o caso, essa espera vai de **0 a 10 dias**. Quando não vem
orientação, a espera é zero.

É por isso que duas assinaturas recusadas no mesmo dia podem ter próximas tentativas em datas
diferentes: o que muda é o motivo da recusa, não a configuração do seu produto.

## Uma data marcada nunca é atropelada

Se já existe uma data de cobrança marcada, nenhuma regra cobra antes dela. No dia marcado o caso é
reavaliado, e aí sim a cobrança pode acontecer.

A única coisa que vence uma espera é o **orçamento de tentativas**. Se as 3 tentativas já foram
gastas, o ciclo encerra mesmo com uma data marcada de pé. A lógica é simples: não sobrou tentativa
para gastar, então não há o que esperar.

## O que encerra o ciclo

* As **3 tentativas** se esgotaram — avaliado antes de qualquer espera.
* A **janela de 20 dias** venceu.
* Não sobrou **nenhuma data possível** dentro da janela.
* A recusa apontou **bloqueio ligado à pessoa**.

### O que o encerramento significa para o comprador

<Warning>
  **Encerrado o ciclo, a assinatura é cancelada e o comprador perde o acesso ao produto.** No
  mesmo momento a Assiny dispara o evento correspondente por webhook — é por ele que a sua área de
  membros remove o acesso da pessoa. Veja [Introdução aos webhooks](/webhooks/introducao).
</Warning>

Enquanto a régua está correndo, o acesso continua liberado. Essa é a janela para falar com o
cliente — depois do encerramento, a conversa já é de recuperação.

Na tela de [Assinaturas](/vendas/assinaturas), esse desfecho aparece com o status **Cancelado por
tentativas** — o encerramento involuntário, que não partiu nem de você nem do comprador.

### Ciclo encerrado não volta atrás

Um ciclo encerrado **não é reavaliado**. Se um pagamento entrar depois do encerramento, o estado
não se reverte sozinho — é um caso para o suporte da Assiny tratar manualmente.

## Uma falha nossa não derruba a sua assinatura

**Informação faltando nunca encerra um ciclo.** Dado de cartão ilegível, consulta interna
indisponível — em todos esses casos a régua segue em frente e registra o problema em vez de
cancelar.

O que encerra é o calendário, o limite de tentativas e o bloqueio ligado à pessoa. Nunca um erro de
leitura do nosso lado.

E se a primeira cobrança do ciclo nunca chegou a rodar, a janela de 20 dias não vale sozinha: o
ciclo ganha um **prazo de graça** que vai até a data de cobrança do ciclo seguinte.

## A ordem em que tudo é avaliado

A ordem não é acidental. O limite de tentativas vem primeiro justamente porque ele vence as
esperas.

```mermaid theme={null}
flowchart TD
    A["Avaliacao diaria do ciclo"] --> B{"Ja foram 3 tentativas?"}
    B -->|Sim| Z1["ENCERRA o ciclo"]
    B -->|Nao| F{"Ha data marcada no futuro?"}
    F -->|Sim| G["ESPERA ate a data"]
    F -->|Nao| H{"Passou da janela de 20 dias?"}
    H -->|"Sim, e alguma tentativa rodou"| Z2["ENCERRA o ciclo"]
    H -->|"Sim, mas nenhuma tentativa rodou"| I["Prazo de graca ate o proximo ciclo"]
    H -->|Nao| M["COBRA"]
```

E, quando uma recusa chega:

```mermaid theme={null}
flowchart TD
    A["Recusa recebida"] --> B{"Ja foram 3 tentativas?"}
    B -->|Sim| Z["ENCERRA o ciclo"]
    B -->|Nao| C{"Bloqueio ligado a pessoa?"}
    C -->|Sim| Z
    C -->|Nao| G{"Saldo insuficiente?"}
    G -->|Nao| F["Apenas registro - a avaliacao diaria decide"]
    G -->|Sim| H{"Ha dia 5, 15 ou 20 apos o piso, dentro da janela?"}
    H -->|Sim| I["REAGENDA para esse dia"]
    H -->|Nao| J{"O piso cabe na janela?"}
    J -->|Sim| K["REAGENDA para o piso"]
    J -->|Nao| Z
```

## Reativar recomeça o ciclo

Um ciclo encerrado não é o fim da relação. Nas telas de [Assinaturas](/vendas/assinaturas) e de
[Parcelamentos](/vendas/parcelamentos) você **reativa** a cobrança, e isso abre um ciclo novo, com
o orçamento de tentativas zerado.

**Combine a data antes de reativar.** Reativar num dia em que o cartão continua sem limite gasta
tentativa à toa. Fale com o cliente, descubra quando o limite volta ou qual cartão usar, e só então
reative.

## O que a plataforma não faz

**A Assiny não negativa o cliente inadimplente.** Não existe protesto, inscrição em órgão de
proteção ao crédito ou cobrança judicial pela plataforma. O que existe é a régua de recuperação e a
suspensão do acesso.

Cobrar uma dívida que sobrou depois disso é uma decisão sua, fora da plataforma.

## Onde acompanhar

| Tela | O que mostra |
| - | - |
| [Assinaturas](/vendas/assinaturas) | As assinaturas por status, com o histórico de cobranças |
| [Parcelamentos](/vendas/parcelamentos) | Os parcelamentos ativos, finalizados e cancelados |
| [Vendas](/vendas/transacoes) | A transação recusada, com o **motivo da recusa** em coluna própria |

O motivo da recusa muda a conversa: falta de saldo pede uma nova data ou outro cartão, enquanto um
bloqueio do emissor só o cliente resolve com o banco.

<CardGroup cols={2}>
  <Card title="Status de venda" icon="receipt" href="/vendas/status-de-venda">
    Como a recusa aparece no extrato
  </Card>

  <Card title="Smart Installments" icon="money-check-dollar" href="/apps/smart-installments">
    O parcelamento inteligente e a inadimplência que ele cria
  </Card>

  <Card title="Assinaturas" icon="repeat" href="/vendas/assinaturas">
    Churn, renovação e o histórico de cada assinante
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/introducao">
    O evento que avisa a sua área de membros
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.