Benefícios
- Automatização completa
- Monitoramento centralizado via Dashboard
- Webhooks para notificações de eventos
- Provedor-agnóstico + uso do Fluxo Inteligente
Ciclo de vida da assinatura
Assinaturas podem ser definidas com frequência semanal, mensal, trimestral ou anual. O dia de vencimento segue regras específicas:Frequências e regras
- weekly: sempre mesmo dia da semana de
startAt - monthly: mesmo dia do mês (ou próximo dia válido)
- quarterly: a cada 3 meses, idem ao mensal
- yearly: mesmo dia/ano (ou adaptação para anos bissextos)
Estados das assinaturas
| Estado | Descrição |
|---|---|
created | Assinatura criada, aguardando primeira cobrança |
trialing | Em período de trial |
active | Assinatura ativa com cobrança recorrente |
paused | Temporariamente suspensa |
canceled | Encerrada definitivamente |
unpaid | Inadimplente após falhas |
expired | Exauriu as faturas permitidas |
Retentativas & estratégia
Fluxo padrão de retentativas (5 tentativas)1
D+0
Tentativa inicial no dia da fatura
2
D+1
Primeira retentativa (1 dia depois)
3
D+4
Segunda retentativa (4 dias depois)
4
D+9
Terceira retentativa (9 dias depois)
5
D+16
Última retentativa (16 dias depois)
retryPolicy nas configurações.
Erros irreversíveis
O camporetryable da transação determina se a assinatura deve seguir as retentativas completas ou falhar imediatamente. Isso se deve porque alguns erros são passíveis de multa caso insistirmos em cobrar.
Confira na tabela erros quais são irreversíveis.
Consequências da falha completa
Se todas as retentativas falharem:- A fatura recebe status
failed- Comportamento padrão: assinatura vai para
unpaid - Se
cancelAfterAllRetriesestiver ativo:canceled
- Comportamento padrão: assinatura vai para
- Status
unpaid: próximas faturas ainda serão processadas - Status
canceled: não haverá mais cobranças automáticas
Integração via API
Você pode integrar o motor de recorrência via API.Comece a integração
Siga o passo a passo para implementar o motor de recorrência na sua aplicação.