Uma série de novos endpoints para retornar dados resumidos de uma cobrança foi criado. Estes endpoint é vantajoso pois tem um retorno mais rápido e possuem um payload mais leve, trazendo um melhor desempenho considerando os endpoints padrão de cobrança.

Confira as referências:

Agora é possível adicionar uma descrição no objeto de Split. Estas informações serão mostradas na tela de detalhes do split na aplicação web.

Agora é possível configurar o valor do split de cada parcela de um parcelamento. Após criar um novo parcelamento, você pode utilizar o endpoint de "Atualizar splits do parcelamento" para definir o número de parcela e o valor do split de cada uma, em uma array.

PUT /v3/installments/{id}/splits
Confira a referência deste endpoint.

A partir de 16/09/2024, será criado um novo motivo de cancelamento do split para o campo cancellationReason com o conteúdo: WALLET_UNABLE_TO_RECEIVE.

O que você precisa fazer:

  • Certifique-se que sua aplicação está preparada para receber também no campo cancellationReason o conteúdo: WALLET_UNABLE_TO_RECEIVE
  • Ajuste seu código até o dia 15/09/2024 para evitar que sua integração seja interrompida.

Recentemente implementamos na API o campo incomeValue nas requisições de atualização de dados comerciais. Este campo recebe um valor do tipo number, no retorno o campo muda o nome para incomeRange onde transformamos este valor para um ENUM seguindo alguns critérios pré-estabelecidos pelo BACEN.

Porém, devido a uma nova requisição do BACEN, agora necessitamos padronizar o campo, deixando o retorno o mesmo valor informado na requisição. A partir de hoje ao realizar chamadas na API referentes aos dados comerciais, o campo de faturamento/renda mensal retornará o campo incomeValue, do tipo number e o campo incomeRange como tipo ENUM.

Atualize sua integração para receber os dados do novo campo, pois, a partir da data 20/09/2024 o campo incomeRange não será mais enviado.

Até este momento, o fluxo de webhook entendia como uma resposta de sucesso apenas as requisições onde sua aplicação respondesse 200 OK para o Asaas. No entanto, depois de recebermos alguns feedbacks da comunidade , alteramos a regra e agora é possível enviar qualquer status code de resposta que pertença ao intervalo 2xx, sendo eles:

  • 200 OK - A solicitação foi bem-sucedida.
  • 201 CREATED - A requisição foi bem sucedida e um novo recurso foi criado como resultado.
  • 202 ACCEPTED - A solicitação foi recebida, mas ainda não foi atendida.
  • 203 NON-AUTHORITATIVE INFORMATION - Esse código de resposta significa que os metadados retornados não são exatamente os mesmos que estão disponíveis no servidor de origem, mas são coletados de uma cópia local ou de terceiros.
  • 204 NO CONTENT - Não há conteúdo para enviar para esta solicitação, mas os cabeçalhos podem ser úteis.
  • 205 RESET CONTENT - Diz ao agente do usuário para redefinir o documento que enviou esta solicitação.
  • 206 PARTIAL CONTENT - Este código de resposta é usado quando o cabeçalho Range é enviado do cliente para solicitar apenas parte de um recurso.
  • 207 MULTI-STATUS - Transmite informações sobre vários recursos, para situações em que vários códigos de status podem ser apropriados.
  • 208 ALREADY REPORTED - Usado dentro de um elemento de resposta <dav:propstat> para evitar enumerar repetidamente os membros internos de várias ligações para a mesma coleção.-
  • 226 IM USED - O servidor atendeu a uma solicitação GET para o recurso e a resposta é uma representação do resultado de uma ou mais manipulações de instância aplicadas à instância atual.

Temos uma informação importante: devido a ajustes internos, iremos migrar o domínio da nossa API de asaas.com/api ou www.asaas.com/api para api.asaas.com.

Essa migração vai ocorrer no dia 20/09.

O que você precisa fazer:
👉 Atualizar as chamadas da API do Asaas para usar o domínio api.asaas.com.

Exemplo: https://asaas.com/api/v3/payments => https://api.asaas.com/v3/payments/

❗️

Importante

Caso o ajuste não seja feito até 20/09, não será possível usar nossos serviços de API.

Em Sandbox nada muda.

A nova URL já funciona e você já pode começar a utilizá-la. Mais infos aqui.

Caso você precise de ajuda, estamos disponíveis de segunda a sexta, das 09:00 às 18:00, por aqui mesmo ou pelo email [email protected].