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 cuida do agendamento, execução e retentativas das cobranças, permitindo um controle centralizado, com monitoramento via Dashboard e webhooks para notificações.

​
Benefícios

  • Automatização completa do processo de cobranças recorrentes: você não precisa se preocupar com o agendamento, execução e retentativas das cobranças, o motor de recorrência cuida disso para você.
  • Monitoramento centralizado via Dashboard da Malga: você pode acompanhar o status de todas as cobranças recorrentes, além de ter acesso aos detalhes de cada transação.
  • Webhooks para notificações: além das notificações de status de cobranças, o motor de recorrência envia webhooks para notificações de eventos importantes, como cancelamento, alteração de status da assinatura, entre outros.
  • Agnóstico a provedores: o motor de recorrência é agnóstico aos provedores de pagamento, permitindo que você use qualquer provedor de pagamento que a Malga suporte. Além disso, ele utiliza o Fluxo Inteligente para garantir a melhor taxa de aprovação das cobranças.

​
Ciclo de vida de uma assinatura

Assinaturas podem ser diárias, semanais, mensais, trimestrais ou anuais. O dia do vencimento é variado, dependendo do intervalo da recorrência.
  • Diário (daily): cobrança diária, iniciando pelo startAt.
  • Semanal (weekly): sempre no mesmo dia da semana de startAt.
  • Mensal (monthly): no mesmo dia do mês de startAt. Se o dia não existir (ex.: 31), usa-se o próximo dia possível.
  • Trimestral (quarterly): a cada 3 meses, no mesmo dia do mês de startAt. Se o dia não existir (ex.: 31), usa-se o próximo dia possível.
  • Anual (yearly): no mesmo dia do ano de startAt. Se a data não existir naquele ano, usa-se o próximo dia possível.

​
Retentativas e recuperação de falhas

Todo pagamento acontecerá no fluxo inteligente de cartão de crédito definido no merchantId utilizado na criação da assinatura. Isso garante que as cobranças sejam feitas com a melhor taxa de aprovação possível. Quanto aos pagamentos que falham, o motor de assinaturas realiza retentativas automáticas em janelas fixas tentando recuperar clientes que poderiam se tornar inadimplentes.

​
Assinaturas diárias

  • D+0: falha inicial (no vencimento do ciclo)
  • D+1: 1ª retentativa
  • D+2: 2ª retentativa
  • D+3: 3ª retentativa (última tentativa)

​
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 (última tentativa)
Se todas as retentativas falharem, o ciclo fica failed, e a assinatura ficará unpaid. Próximos ciclos continuam sendo tentados nas datas futuras até cancelamento manual.

​
Integração

Disponibilizamos uma API para você integrar o motor de recorrência com o seu sistema.

Getting started

Passo a passo para começar a usar o motor de recorrência.