Implementamos um novo sistema de penalização nas tentativas de disparo dos eventos.

Quando o retorno do envio apresentar falhas, as tentativas serão espaçadas com intervalos de tempo crescentes. Isso dá mais tempo para a aplicação se recuperar de instabilidades antes que a fila seja pausada.

A penalização pode ser removida ativamente via API ou pela interface para acelerar o reprocessamento de uma fila.

Saiba mais em nosso Guia de Penalização de Filas.

Lançamos três novos segmentos de webhooks para dar a você controle e visibilidade total sobre eventos críticos da sua conta:

• Eventos de Chaves de API: Seja notificado em tempo real sobre a criação, exclusão, ativação, desativação ou expiração de qualquer chave de API em sua conta. Monitore a saúde da sua integração e aumente a segurança.
• Eventos de Bloqueios de Saldo: Receba alertas automáticos quando um valor for bloqueado ou desbloqueado em seu saldo por motivos como disputas Pix (MED) ou ordens judiciais, eliminando a necessidade de consultas manuais ao extrato.
• Eventos de Movimentações Internas: Acompanhe créditos e débitos internos que não são originados de cobranças, como repasses de Split, transferências entre contas Asaas, automatizando sua conciliação.

Consulte todos os novos eventos em nosso Guia de Webhooks.

A partir de hoje, as respostas de erro 401 Unauthorized da nossa API foram aprimoradas para retornar mensagens detalhadas e acionáveis. Em vez de um erro genérico, a API agora informa a causa específica da falha de autenticação, como o uso de uma chave no ambiente errado (Produção vs. Sandbox), a ausência do cabeçalho access_token ou o uso de uma chave inválida.

Esta melhoria visa reduzir o tempo de debugging e facilitar o processo de integração com o Asaas. Para ver a lista completa dos novos erros e como tratá-los, consulte nosso Guia de Autenticação atualizado.

Foi lançado o endpoint PUT subscriptions/{id}/creditCard, que permite atualizar o cartão de crédito de uma assinatura sem realizar a cobrança no momento da chamada.

Esse recurso atende a uma demanda recorrente de clientes que desejavam trocar o cartão vinculado a uma assinatura em andamento sem precisar realizar um pagamento imediato.

Além disso:

• Todas as cobranças pendentes associadas à assinatura serão automaticamente atualizadas com os dados do novo cartão.

Importante:
Esse endpoint substitui o uso da rota /payments/{id}/payWithCreditCard em casos onde a intenção não é cobrar no momento da troca de cartão.

O Checkout Asaas é a nova forma de oferecer uma experiência de pagamento completa, simples e segura dentro do seu próprio fluxo de compra. Ele permite que você crie um formulário de checkout responsivo, já pronto para uso, diretamente via API — ideal para e-commerces e plataformas SaaS que desejam agilidade na implementação.

Entre as principais funcionalidades, destacam-se:

• Formulário de checkout personalizável com poucos cliques;
• Suporte a Pix, boleto bancário e cartão de crédito (à vista, parcelado ou assinatura);
• Redirecionamento automático após o pagamento;
• Expiração configurável do link de pagamento;
• Split de pagamentos nativo;
• Possibilidade de pré-preenchimento com dados do cliente (ou coleta direta na tela de checkout).

👉 Confira a documentação completa para começar:Guia completo sobre Checkout Asaas

A partir de 20/03, é possível utilizar oficialmente a Conta Escrow no Asaas.

A Conta Escrow é um recurso que permite a retenção temporária de valores transacionados, bloqueando os fundos até que as condições de liberação sejam atendidas. Desta forma, o valor fica retido como uma garantia de que as obrigações de ambas as partes serão cumpridas antes da liberação do valor.

Esse recurso pode ser usado em:

• Marketplaces: garantindo que o vendedor receba apenas após a entrega do produto.
• Compra e venda de imóveis: o pagamento fica retido até que todas as obrigações contratuais sejam resolvidas.
• Aluguéis: Evita golpes, garantindo que o proprietário só receba após o check-in do hóspede (exemplo: Airbnb).
• Bilheteria e ingressos: Evita fraudes, garantindo que o produtor receba apenas após o evento ocorrer.
• Entre outros...

Veja as informações completas sobre a Conta Escrow em nosso guia de integrações.

Estamos implementando melhorias na chamada "Decodificar um QRCode para pagamento", com o intuito de otimizar o desempenho das nossas APIs. Como parte dessa otimização, o parâmetro endToEndIdentifier será removido da resposta desse endpoint.

Esse ajuste acontecerá no dia 22/04.

Caso sua aplicação necessite obrigatoriamente deste campo, orientamos que faça contato conosco através do e-mail [email protected] para maiores esclarecimentos.

Agora é possível realizar algumas ações de Sandbox via API. Disponibilizamos duas novas rotas:

• Confirmar o pagamento — Esse endpoint confirma o pagamento de uma cobrança no ambiente sandbox.
• Forçar o vencimento de uma cobrança — Esse endpoint força o vencimento de uma cobrança no ambiente sandbox.

Essa melhoria traz um grande benefício, principalmente para subcontas White Label, mas pode ser usada livremente por todas as contas. Lembrando que são ações exclusivas do ambiente de Sandbox.

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}

Exemplo de chave:

• Produção: $aact_prod_000YTU5YTE0M2M2N2I4MT…
• Sandbox: $aact_hmlg_000YTU5YTA1X3B5T7C9YZ…

Caso queira atualizar suas chaves de API para garantir que estejam no novo formato, basta acessar o menu do usuário da sua conta Asaas > Integração > Chaves de API e criar novas chaves API.

A alteração estará disponível a partir do dia 10/03!

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.

Desde o dia 22/01, estamos permitindo a criação de parcelamentos no cartão de crédito em até 21x para cartões de bandeira Visa e Master.

Anteriormente, era suportado parcelamentos de até 12 parcelas para todas as bandeiras.
Para outras bandeiras exceto Visa e Master, o limite continua sendo de 12 parcelas.

O que eu preciso fazer?
Caso necessite criar o parcelamento maior que 12x, basta continuar usando a mesma API de criação de cobrança ou criação de cobrança parcelada, e indicar a quantidade correta de parcelas na sua criação.

Veja mais detalhes sobre cobranças parceladas em nosso guia de integrações -> https://docs.asaas.com/docs/criar-uma-cobranca-parcelada