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

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 (https://docs.asaas.com/reference/realizar-consulta). Por esse motivo, a propriedade state será retirada no dia 17/02.

O que eu preciso fazer?
Atualizar a propriedade “state”, que será retirada no dia 17/02 e poderá gerar um mau funcionamento para a sua integração.

Importante: Recomendamos que este ajuste seja realizado até o dia 17/02.

Clique aqui e consulte a documentação da Consulta Serasa.

Liberamos a possibilidade de nosso cliente iniciar uma disputa, caso receba um chargeback que considere indevido, e também consultar os chargebacks via API!

Na API temos 2 novos endpoints, sendo:

• Criar disputa de chargeback - https://docs.asaas.com/reference/criar-disputa-de-chargeback
• Listar chargebacks - https://docs.asaas.com/reference/listar-chargebacks

Em caso de dúvidas dos documentos a serem enviados na chamada de “Criar Disputa”, podem entrar em contato com o gerente de contas. Se a dúvida for com relação às chamadas API, podem contatar nosso suporte pelo e-mail [email protected]

Quando o valor total do split em uma assinatura excede o valor líquido a receber, a assinatura é bloqueada, o split desativado e novas cobranças recorrentes são interrompidas. Um webhook notifica o bloqueio e concede 2 dias úteis para ajustar o split ou o valor da assinatura. Se o ajuste for feito a tempo, o desbloqueio ocorre, e as cobranças com o split atualizado são retomadas. Caso contrário, o bloqueio expira, o split permanece desativado, e um webhook informa que a assinatura foi liberada sem o split.

Eventos do webhook utilizados para comunicação:
● SUBSCRIPTION_SPLIT_DIVERGENCE_BLOCK - Assinatura bloqueada por divergência de split.
● SUBSCRIPTION_SPLIT_DIVERGENCE_BLOCK_FINISHED - Bloqueio da assinatura por divergência de split foi finalizado.

A explicação completa pode ser verificada em nossa documentação na aba Fluxo de bloqueio de assinatura por divergência de split.