A partir do dia 25/03/2024 começaremos a enviar um campo com o ID dos eventos em todos os Webhooks. Isso ajudará desenvolvedores a tratarem eventos duplicados, já que os Webhooks do Asaas garantem a entrega "at least once" (ao menos uma entrega).
Confira a nova estrutura dos objetos que será aplicada:
Por exigência do Bacen, agora é obrigatório que todos os nossos clientes informem seu faturamento/renda mensal.
O que você precisa fazer?
Atualize sua integração para o envio do campo incomeValue até 30/05/2024
O envio da renda (PF) ou faturamento mensal (PJ) através do campo incomeValue nos endpoints de Atualização de Dados Comerciais (/v3/myAccount/commercialInfo) e Criação de Subcontas (/v3/accounts) passará a ser obrigatório e você precisa atualizar sua integração para que as chamadas sejam enviadas com essa informação.
A partir do dia 30/05, chamadas para estes endpoints sem essa informação retornarão erro, indicando que o campo é obrigatório.
Atualize os dados cadastrais de todas as suas contas até 30/08 para que elas não sejam bloqueadas
É necessário que todas as contas atualizem suas informações cadastrais!
Principalmente se você utiliza White Label, solicite o faturamento/renda mensal aos seus clientes e atualize os dados através do endpoint de Atualização de Dados Comerciais (/v3/myAccount/commercialInfo).
As contas que não forem atualizadas até 30/08 serão bloqueadas até que os dados sejam informados.
Com este endpoint é possível enviar um valor de cobrança com parcelas ou não, e receber uma simulação dos valores líquidos e taxas que serão aplicadas.
Começamos a liberação parcial da nova tela de Webhooks na aplicação web do Asaas. Com ela, será possível:
Escolher a quantidade de eventos que você quiser para cada webhook;
Selecionar diversos tipos de eventos dentro de um mesmo webhook;
Definir e/ou alterar o nome de cada webhook;
Utilizar mais de uma URL para o mesmo tipo de evento;
Além disso, aumentamos a quantidade limite de Webhooks configurados, de 7 para 10.
Você pode habilitar a nova tela, caso ainda não tenha sido liberada, utilizando os novos endpoints de Webhooks. Ao realizar uma chamada utilizando este endpoint você automaticamente irá visualizar a nova tela de Webhooks ao acessar nossa aplicação web.
O endpoint para retornar cobranças de um parcelamento foi modificado para seguir o mesmo padrão do endpotin que retorna as cobranças de uma assinatura. O endpoint antigo ainda continuará funcionando mas foi descontinuado e não receberá novas manutenções.
Agora, além da URL de retorno através do parâmetro callback nas cobranças avulsas, parcelamentos e links de pagamento, é possível redirecionar o seu cliente após o pagamento de Assinaturas também.
O parâmetro daysAfterDueDateToCancellationRegistration foi adicionado no endpoint de cobranças, permitindo definir em quantos dias um boleto é baixado após o vencimento.
No dia 21/12, em 14 dias, implementaremos uma alteração no Identificador Único (ID) da API no produto Notificações de Cobrança.
Como é hoje:not_000131365226(prefixo + 12 numéricos) Como será:not_6imenp7fj5osqd88(prefixo + 16 alfanuméricos)
A alteração não será retroativa, então cobranças e recursos criados antes do dia 21/12 permanecerão com os seus IDs inalterados. Além disso, nenhum outro produto diferente do citado neste comunicado (Notificações de Cobrança) passará por alterações.
Recomendamos que você avalie se está usando essa informação para consultas internas e se precisará realizar algum ajuste em sua integração. Essa alteração estará disponível também no Sandbox para testes a partir da próxima quinta-feira, 14/12.