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

# Assinaturas — Referência

> O modelo de recorrência: oferta com cadência, faturas por ciclo e cancelamento.

Uma **assinatura** nasce de uma [oferta](/catalogo-crm/produtos-e-ofertas) com cadência recorrente. A primeira cobrança acontece no checkout; as seguintes são agendadas automaticamente por ciclo.

## Modelo

| Objeto | Papel |
| - | - |
| Assinatura | Contrato de recorrência: comprador + oferta + cadência + estado |
| Fatura | Cobrança de cada ciclo, com valor e resultado |
| Oferta | Define valor recorrente e método (cartão ou PIX Automático) |

## Estados e ciclo

```mermaid theme={null}
flowchart LR
  A[Checkout aprovado] --> B[ATIVA]
  B --> C{Ciclo}
  C -->|cobrança ok| B
  C -->|falha| D[Retentativas]
  D --> B
  B -->|cancelamento| E[CANCELADA]
```

## Regras importantes

* O valor das faturas vem da oferta **no momento da assinatura** — mudar a oferta depois não altera assinaturas existentes.
* Cancelamento é imediato: nenhuma nova fatura; as pagas não são afetadas.
* O comprador pode gerenciar a assinatura no [portal do cliente](/pagamentos/assinaturas#portal-do-cliente) — o acesso é controlado por sessões que você cria e revoga por API.

<Tip>
  No sandbox, use a simulação de ciclo para testar faturas e renovações sem esperar o calendário.
</Tip>


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