Alteração na estrutura de URLs públicas do Asaas
A partir de 28 de setembro de 2026, iniciaremos uma atualização gradual na estrutura de algumas URLs públicas geradas pelo Asaas e retornadas pela API.
Com essa alteração, essas URLs passarão a adotar um novo formato, incluindo um segmento adicional em seu caminho.
Por exemplo, um Link de Pagamento que atualmente possui o formato:
https://www.asaas.com/c/12345678910
passará a ser gerado como:
https://www.asaas.com/000/c/12345678910
O que muda para a integração?
Os endpoints da API permanecem os mesmos. A alteração ocorre somente na estrutura das URLs públicas geradas pelo Asaas ou retornadas nos recursos da API.
Integrações que utilizam a URL completa retornada pelo Asaas não precisam realizar alterações.
Caso sua aplicação possua alguma lógica baseada na estrutura interna dessas URLs, como expressões regulares, extração de identificadores pelo caminho ou validação de segmentos específicos, recomendamos revisar a implementação para não depender de um formato fixo.
A URL deve ser utilizada exatamente como retornada pelo Asaas. O segmento adicional presente no caminho poderá variar, portanto, não recomendamos criar regras que dependam especificamente do valor /000/.
E os links já existentes?
Links gerados anteriormente continuarão funcionando normalmente no formato atual.
Após a liberação de cada recurso, os novos links passarão a ser gerados utilizando a nova estrutura.
Quais URLs serão afetadas?
A alteração será aplicada gradualmente a diferentes URLs públicas do Asaas. Entre os principais recursos afetados estão:
- Consentimento do Open Finance
- Links de Pagamento
- Checkout 2.0
- Comprovantes
- Arquivos públicos
- Solicitação de estorno
As alterações serão realizadas progressivamente, portanto, durante o período de liberação, alguns recursos poderão já utilizar o novo formato enquanto outros ainda permanecerão com a estrutura atual.
Cronograma
A atualização será realizada gradualmente entre 28 de setembro e 2 de outubro de 2026.
A primeira liberação ocorrerá em 28 de setembro, para URLs relacionadas ao Consentimento do Open Finance.
Os Links de Pagamento passarão a utilizar o novo formato a partir de 29 de setembro.
As demais URLs afetadas serão atualizadas progressivamente até 2 de outubro de 2026, desde que não sejam identificados problemas durante as liberações.