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

# Assinaturas e recorrência

> Cobranças recorrentes automáticas: intervalos, período de teste, tentativas de cobrança e estatísticas.

Quando um produto é configurado como recorrente (veja [Produtos](/guias-do-painel/produtos)), cada compra gera uma **assinatura**, cobrada automaticamente a cada ciclo.

## Ciclo de vida de uma assinatura

<Steps>
  <Step title="Criada">
    A assinatura nasce com um intervalo (`daily`, `weekly`, `monthly`, `yearly`) e uma quantidade de intervalos (ex.: a cada 2 meses), além de uma data da próxima cobrança.
  </Step>

  <Step title="Período de teste (opcional)">
    É possível configurar dias de trial antes da primeira cobrança.
  </Step>

  <Step title="Cobranças automáticas">
    Um job automático processa as cobranças **duas vezes por dia** (aproximadamente às 9h e às 18h), verificando todas as assinaturas ativas cuja próxima data de cobrança já chegou.
  </Step>

  <Step title="Pausa, retomada ou cancelamento">
    O lojista (ou o próprio cliente, dependendo da configuração) pode pausar, retomar ou cancelar uma assinatura a qualquer momento.
  </Step>
</Steps>

## Status possíveis

| Status      | Descrição                                                       |
| ----------- | --------------------------------------------------------------- |
| `active`    | Assinatura em dia, cobrando normalmente.                        |
| `paused`    | Assinatura pausada — não gera novas cobranças até ser retomada. |
| `cancelled` | Assinatura cancelada, não gera mais cobranças.                  |
| `expired`   | Assinatura chegou à data final configurada (se houver).         |

## Regras de nova tentativa (retry)

Quando uma cobrança falha, o sistema tenta novamente automaticamente:

1. Primeira falha → nova tentativa ainda no mesmo dia (segundo horário do job).
2. Segunda falha → nova tentativa no dia seguinte.
3. Terceira falha → última tentativa.
4. Após atingir o número máximo de tentativas (configurável, padrão 3) → a assinatura é **cancelada automaticamente**.

<Note>
  A cada tentativa bem-sucedida ou falha, uma [notificação](/guias-do-painel/notificacoes) é criada automaticamente para o cliente e/ou para o lojista.
</Note>

## Estatísticas da loja

Cada loja tem acesso a métricas agregadas de suas assinaturas:

* Total de assinaturas ativas e canceladas
* Receita total e **MRR** (receita mensal recorrente)
* Taxa de churn (cancelamento)
* Distribuição por intervalo (mensal, anual etc.)
* Cobranças futuras e cobranças falhadas

## Área do cliente

O comprador tem acesso a uma área própria para visualizar as assinaturas que possui na loja, incluindo status e histórico de cobranças.

<Warning>
  A integração de cobrança recorrente com o gateway de pagamento (Mercado Pago/Asaas) processa o pagamento real a cada ciclo; consulte [Configurações de pagamento](/guias-do-painel/configuracoes-de-pagamento) para garantir que o gateway está corretamente conectado antes de vender produtos recorrentes.
</Warning>