Novo fluxo de eventos em boletos

Com o objetivo de acompanhar as recentes mudanças realizadas pela Febraban sobre o prazo de compensação dos boletos bancários, o Asaas passou a liquidar duas vezes ao dia os pagamentos realizados através desta forma de cobrança, trazendo mais agilidade para a sua operação.

  • Pagamentos realizados das 00h até 13h29 serão liquidados no mesmo dia (D+0) a partir das 17h
  • Pagamentos realizados das 13h30 até 23h59 serão liquidados no próximo dia (D+1) a partir das 3h

Essa mudança visa trazer diversos impactos positivos, principalmente para o seu fluxo de caixa, já que os pagamentos recebidos via boleto poderão ser compensados no mesmo dia.

Para atender a essa mudança, o fluxo de eventos para boletos será alterado: o status CONFIRMED agora será exibido sempre antes do RECEIVED.

O fluxo do boleto funcionará da mesma forma que o de cartão de crédito:

Para cobranças recebidas sem atraso:
PAYMENT_CREATED > PAYMENT_CONFIRMED > PAYMENT_RECEIVED

Para cobranças recebidas com atraso:
PAYMENT_CREATED > PAYMENT_OVERDUE > PAYMENT_CONFIRMED > PAYMENT_RECEIVED

🚧

Importante

Essa alteração será aplicada a partir do dia 02/07/2024, portanto atualize sua integração esperando que este status esteja presente na sua aplicação e no recebimento de Webhooks.

Remoção do campo tradingName em dados comerciais das contas

A partir do dia 15/04/2024 o campo tradingName não será mais retornado em endpoints de criação ou listagem de subcontas /v3/accounts, nem em recuperação ou atualização de dados comerciais /v3/myAccount/commercialInfo. Na maioria dos casos, este campo é retornado como null e não tem utilização em nenhum outro local da API.

Inclusão de campo com ID do evento em envios de Webhooks

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:

{  
  "id": "evt_05b708f961d739ea7eba7e4db318f621&368604920",  
  "event": "PAYMENT_CREATED",  
  "payment": {  
    "object": "payment",  
    "id": "pay_qgddos6jdr4cdz"  
...

Saiba mais: https://docs.asaas.com/docs/sobre-os-webhooks#gerencie-eventos-duplicados

⚠️ Novo campo obrigatório de faturamento/renda mensal para todas as contas

Por exigência do Bacen, agora é obrigatório que todos os nossos clientes informem seu faturamento/renda mensal.

O que você precisa fazer?

  1. 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.

Saiba mais:
https://docs.asaas.com/reference/atualizar-dados-comerciais
https://docs.asaas.com/reference/criar-subconta

  1. 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.

Configuração personalizada para eventos de Webhooks

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.

Clique aqui e saiba mais.