Skip to main content
A API de Assinaturas está em fase de desenvolvimento e atualmente está disponível em versão beta. Caso tenha interesse em utilizá-la, entre em contato com o suporte ou com o time comercial.
A Malga oferece um Motor de Assinaturas que automatiza todo o ciclo de vida de cobranças recorrentes — desde o agendamento e execução até as retentativas em caso de falha — com monitoramento centralizado via Dashboard e notificações via Webhooks.

​
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

EstadoDescrição
createdAssinatura criada, aguardando primeiro pagamento
trialingEm período de trial
activeAssinatura ativa com cobrança recorrente
pausedTemporariamente suspensa
canceledEncerrada definitivamente
unpaidInadimplente após falhas
expiredExauriu os ciclos permitidos

​
Retentativas & estratégia

Fluxo padrão de retentativas (5 tentativas)
1

D+0

Tentativa inicial no dia do ciclo
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)
Você também pode personalizar a estratégia de retentativas através do campo retryPolicy nas configurações.

​
Erros irreversíveis

O campo retryable 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:
  • O ciclo recebe status failed
    • Comportamento padrão: assinatura vai para unpaid
    • Se cancelAfterAllRetries estiver ativo: canceled
  • Status unpaid: próximos ciclos ainda serão processados
  • 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.