startAt
definido como a data atual, o motor de recorrência da Malga processa o primeiro pagamento imediatamente. Este comportamento especial permite que você inicie a cobrança no mesmo dia da criação da assinatura.
Importante: O campo
startAt
deve ser informado em formato UTC (YYYY-MM-DD).Comportamento especial
Ao definirstartAt
como a data atual, o motor de recorrência:
- Processa o pagamento imediatamente após a criação da assinatura
- Retorna informações detalhadas sobre o processamento na resposta da API
- Envia webhooks específicos para notificar sobre o resultado do pagamento
- Atualiza o status da assinatura baseado no resultado do pagamento
Exemplo de criação com startAt sendo hoje
Webhooks específicos
Quando você cria uma assinatura com pagamento instantâneo, você receberá webhooks específicos:Ordem de eventos
- Quando a assinatura é criada:
subscription.created
; - Quando o pagamento é processado:
subscription.activated
(em caso de sucesso);subscription.cycle_failed
(quando há falha no processamento do pagamento);
subscription.unpaid
(após esgotar todas as tentativas de pagamento do ciclo).
Novo webhook: subscription.cycle_failed
Este webhook é enviado quando um ciclo de pagamento falha após todas as retentativas:Observações importantes
- Objeto
lastCycle
: Só é retornado quando há necessidade de pagamento instantâneo, seja na criação da assinatura comstartAt
definido como a data atual ou em uma atualização que altere a data para hoje - Status da assinatura:
- Sucesso:
active
- Erro:
created
(permanece até retentativas esgotadas)
- Sucesso:
- Status do cycle:
- Sucesso:
authorized
- Erro:
retrying
- Sucesso:
- Payment History: Contém detalhes de cada tentativa, incluindo erros
- Next Attempt: Indica quando será a próxima tentativa de pagamento