Ciclo de Vida das Assinaturas
O motor de recorrência gerencia automaticamente o ciclo de vida das suas assinaturas, desde a criação até a expiração. Entender como funciona esse fluxo é essencial para implementar corretamente as ações de gerenciamento.Estados das Assinaturas
- created: Assinatura criada, aguardando primeiro pagamento
- active: Assinatura ativa com pagamentos sendo processados
- paused: Assinatura pausada temporariamente
- canceled: Assinatura cancelada manualmente
- unpaid: Assinatura inadimplente (após falha de todas as retentativas)
- expired: Assinatura expirada (somente após o número de pagamentos autorizados ser igual ao número de ciclos configurados)
Fluxo de Processamento de Pagamentos
Regras de Retentativas
O motor de recorrência segue regras específicas para retentativas baseadas no tipo de assinatura:Assinaturas semanais
- D+0: falha inicial (no vencimento do ciclo)
- D+1: 1ª retentativa
- D+3: 2ª retentativa
- D+5: 3ª retentativa (última tentativa)
Assinaturas mensais/trimestrais/anuais
- D+0: falha inicial (no vencimento do ciclo)
- D+1: 1ª retentativa
- D+4: 2ª retentativa
- D+9: 3ª retentativa
- D+16: 4ª retentativa
Ações Disponíveis por Estado
| Estado | Pausar | Retomar | Cancelar |
|---|---|---|---|
| created | ❌ | ❌ | ✅ |
| active | ✅ | ❌ | ✅ |
| paused | ❌ | ✅ | ✅ |
| canceled | ❌ | ❌ | ❌ |
| unpaid | ❌ | ❌ | ✅ |
| expired | ❌ | ❌ | ❌ |
Transições de Estado
Operações de Gerenciamento
Atualizar uma assinatura
Atualize uma assinatura recorrente com os métodos de pagamento disponíveis na Malga.Ao alterar
cycles, o novo valor não pode ser menor do que a quantidade de ciclos já cobrados.Pausar uma assinatura
Pause uma assinatura recorrente.
Retomar Assinatura
Retomar uma assinatura recorrente.
Cancelar Assinatura
Cancelar uma assinatura recorrente.
Pausar e cancelar não interrompem um ciclo já iniciado, somente ciclos futuros são afetados.