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:

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.