O motor de recorrência da Malga oferece uma API para você gerenciar suas assinaturas recorrentes de forma programática.

​
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/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
Se todas as retentativas falharem, o ciclo fica failed, e a assinatura ficará unpaid. A assinatura permanecerá neste estado e continuará tentando cobrar nos próximos ciclos até que seja cancelada manualmente.

​
Ações Disponíveis por Estado

EstadoPausarRetomarCancelar
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.