Por que o Asaas não reconhece meu Token de Integração?

Verifique se há restrições de IP na sua conta Asaas que possam estar impedindo a validação do Token de Integração.

Esse erro pode ocorrer quando o Asaas não reconhece o Token de Integração informado. Um dos motivos mais comuns é a existência de uma lista de Endereços IP autorizados na sua conta Asaas, que bloqueia requisições vindas de qualquer IP que não esteja nessa lista. Este artigo mostra como verificar essa configuração e, se necessário, autorizar o IP da plataforma.

Pré-requisitos:

• Ter uma conta ativa no Asaas.
• Ter acesso ao painel da conta com permissões de Administrador.
• O Token de Integração já deve ter sido gerado.

Passo 1: Acesse sua conta Asaas

1. Acesse: https://www.asaas.com/login/auth
2. Faça login com uma conta de Produção do Asaas.

Passo 2: Acesse a seção "Integração"

1. Já logado, clique no ícone no canto superior direito da tela.
2. Selecione a opção "Integração".

Passo 3: Acesse a seção "Segurança"

1. Clique na aba Segurança.
2. Role a página até encontrar Endereços IP autorizados na API.

Passo 4: Verifique os Endereços IP autorizados

• Se não houver nenhum endereço IP cadastrado, o Token de Integração pode ser utilizado por qualquer IP normalmente.
• Se houver um ou mais IPs cadastrados, apenas requisições vindas desses endereços serão aceitas — todas as demais serão recusadas.

Se esse for o seu cenário, siga os passos abaixo para adicionar o IP da plataforma à lista de autorizados.

Passo 5: Copie o IP da plataforma

1. Acesse a documentação de firewall: https://flwchat.readme.io/reference/informa%C3%A7%C3%B5es-para-firewall
2. Copie o endereço de IP indicado na página.

Passo 6: Adicione o IP na sua conta Asaas

1. Em Endereços IP autorizados na API, clique em Adicionar IP.

1. Cole o endereço copiado no campo Endereço de IP.
2. Opcional: adicione uma descrição para identificar o IP.
3. Clique em Avançar.

1. Clique em Salvar.

1. Informe o código OTP recebido e clique em Autorizar.

Considerações Adicionais:

• Esse erro ocorre quando a plataforma não consegue localizar um token válido associado à conta. A restrição de IP é um dos cenários mais comuns para esse tipo de falha.
• Se não houver nenhum IP cadastrado, a conta aceita requisições de qualquer endereço. Essa é uma configuração de segurança opcional do Asaas, não obrigatória.
• Se já existem IPs cadastrados e você não deseja removê-los, basta adicionar o IP da plataforma à lista para que a comunicação funcione corretamente.