Breaking changes

A API do Asaas está em constante evolução. Algumas alterações são consideras Breaking changes (alterações significativas) pois podem impactar diretamente integrações que esperam que o Asaas responda sempre da mesma forma.

Todas as Breaking Changes são comunicadas para os clientes que serão impactados por e-mail. Você também pode acompanhar alterações programadas através do nosso canal no Discord ou este documento. As comunicações podem ser enviadas para toda a base de clientes ou somente para clientes que utilizem aquela funcionalidade específica, como subcontas, por exemplo.

Confira abaixo o calendário de alterações significativas com a data em que elas e entrarão em vigor:

Abaixo as alterações significativas que já entraram em vigor:

14/04/2025

⚠️ MUDANÇA NAS CASAS DECIMAIS ACEITAS EM SPLITS

A partir desta data, faremos uma alteração nas casas decimais aceitas na criação ou atualização de splits.

Splits fixos (criados com fixedValue), aceitarão apenas duas casas decimais. Ex: 9.32
Splits percentuais (criados com percentualValue), aceitarão apenas quatro casas decimais. Ex: 92.3444

Caso o split seja criado com mais casas decimais que o permitido, passaremos a retornar uma exceção traduzida, indicando o motivo do erro.

Confira na sua integração a maneira de envio dos splits e ajuste-a caso necessário.

Essa mudança visa padronizar as regras do split e evitar possíveis cortes de casas decimais ou arredondamentos, garantindo que o split seja executado no valor exato indicado em sua criação/atualização.

Qualquer dúvida, basta nos acionar no e-mail [email protected]

10/03/2025

Novidade: Novo Prefixo de Identificação das Chaves API!: Para facilitar a identificação da sua chave API entre os ambientes de Produção e Sandbox, as chaves API agora seguirão um novo prefixo:

Produção: $aact_prod_{hash}
Sandbox: $aact_hmlg_{hash}

Importante:

As chaves já existentes continuarão funcionando normalmente.
O novo formato será aplicado somente às chaves geradas após 10/03.
Não é obrigatório gerar uma nova chave, somente se desejar.

Veja mais sobre aqui.

17/02/2025

Anteriormente, a nossa abrangência de consulta para analisar se um Cliente possuía protesto era estadual. Agora, o Asaas oferece esta consulta em abrangência nacional, não sendo mais necessário informar o estado ao solicitar uma Consulta Serasa. Por esse motivo, a propriedade state será retirada do retorno do recurso no dia 17/02.
Identificamos um retorno incorreto na nossa API de parcelamentos, onde o atributo refunds que deveria retornar uma lista de estornos realizados nesse parcelamento acaba retornando uma lista de lista de estornos. Com isso, para manter a consistência da API, no dia 17/02 iremos alterar seu retorno para que seja uma lista de objetos de estorno.

12/11/2024

A alteração para uso da nova rota de nossa API entrou em vigor. A partir desta data, conforme comunicados prévios, a conexão com o Asaas deve ser realizada através do domínio https://api.asaas.com/v3, conforme descrito em nossa seção de autenticação.