Fluxo de bloqueio de assinatura por divergência de split

Quando uma cobrança recorrente é criada ou uma cobrança pertencente a uma assinatura é processada, o Asaas verifica se o valor líquido da cobrança é suficiente para suportar a configuração de Split de Pagamentos definida para aquela assinatura.

Caso o valor total do split seja superior ao valor líquido disponível, a assinatura será bloqueada automaticamente, o split será desabilitado e novas cobranças recorrentes deixarão de ser geradas até que a situação seja regularizada.

Durante esse processo, o Asaas envia notificações via Webhook para que a integração possa acompanhar todo o ciclo do bloqueio.

Quando esse bloqueio acontece?

O bloqueio ocorre quando:

• uma nova cobrança recorrente é criada;
• uma cobrança pertencente à assinatura é processada;
• o valor líquido da cobrança torna-se inferior ao valor configurado para distribuição do split.

Nessa situação, o Asaas entende que não é possível distribuir corretamente os valores entre os participantes e interrompe automaticamente a geração de novas cobranças.

Como funciona o fluxo

Quando uma divergência é identificada, o fluxo ocorre da seguinte forma:

Criar cobrança
        ↓
Validar valor líquido
        ↓
Detectar divergência
de split
        ↓
Bloquear assinatura
        ↓
Enviar Webhook
        ↓
Aguardar correção
(até 2 dias úteis)

A notificação enviada via Webhook contém informações adicionais na propriedade additionalInfo, permitindo que a aplicação identifique o motivo do bloqueio.

Como desbloquear a assinatura

Caso o valor do split ou o valor da assinatura seja ajustado dentro do prazo de 2 dias úteis, o Asaas realiza automaticamente o desbloqueio.

Nesse cenário:

• a assinatura volta a gerar novas cobranças;
• o split permanece ativo;
• os novos valores passam a ser considerados nas próximas cobranças.

Expiração do bloqueio

Caso nenhuma correção seja realizada dentro do prazo estabelecido:

• o bloqueio é encerrado automaticamente;
• o split permanece desabilitado;
• novas cobranças voltam a ser criadas, porém sem aplicar o split anteriormente configurado.

Uma nova notificação será enviada via Webhook informando que o bloqueio expirou e que a assinatura voltou a gerar cobranças sem distribuição automática de valores.

Eventos de Webhook

Os seguintes eventos são utilizados durante esse processo:

A propriedade additionalInfo traz informações complementares para auxiliar na identificação do motivo do bloqueio ou do desbloqueio.

Exemplo de cenário

Considere uma assinatura cujo valor líquido disponível seja de R$ 90,00.

Se a configuração de split distribuir R$ 100,00, ocorrerá o seguinte fluxo:

Assinatura
        ↓
Cobrança criada
(R$ 90,00 líquidos)
        ↓
Split configurado
(R$ 100,00)
        ↓
Bloqueio automático
        ↓
Webhook enviado

Após ajustar o split para um valor igual ou inferior ao valor líquido disponível, a assinatura poderá voltar a gerar cobranças normalmente.

Boas práticas

Impactos operacionais

Enquanto a assinatura permanecer bloqueada:

• novas cobranças recorrentes não serão criadas;
• o split ficará temporariamente desabilitado;
• poderá haver impacto na distribuição automática dos recebimentos.

Caso o bloqueio expire sem correção, as cobranças voltarão a ser geradas normalmente, porém sem aplicar a configuração de split anteriormente existente.

Próximos passos

Após implementar esse fluxo, recomendamos consultar:

• Split de Pagamentos.
• Criar assinatura.
• Atualizar assinatura.
• Webhooks.
• Eventos de assinatura.
• Fluxo de Webhooks para cobranças.