Dúvidas frequentes

Nesta documentação você encontrará dúvidas frequentes sobre o desenvolvimento com a API do Asaas.

Erro de autorização crítica

Ao realizar algumas chamadas como de transferências, autorização de dados ou pagamento de contas, por exemplo, você pode se deparar com um erro de "Autorização crítica habilitada":

{ 
  "errors": 
  	[ 
      { 
        "code": "invalid_action",
       	"description": "Sua conta possui autorização crítica habilitada. Para efetuar esta ação informe o código de confirmação." 
      } 
    ] 
}

Toda transferência feita no Asaas, exceto em contas White Label, precisam ser aprovadas via token SMS ou token APP. Porém, caso você precise de uma forma mais automática de fazer as transferências, é possível substituir o token por outras funcionalidades de segurança.

É possível fixar IPs no Asaas para que apenas esses IPs possam utilizar a nossa API. Caso qualquer outro IP faça a tentativa, receberá um erro dizendo que ele não é considerado seguro. Com isso, o token de autenticação pode ser removido com segurança.

Outra opção é configurar um webhook de autenticação, conforme consta https://docs.asaas.com/docs/mecanismo-para-validacao-de-transferencias.

Você pode solicitar ao seu gerente de contas para desabilitar a autorização crítica em produção ou entrar em contato com o suporte para desabilitar em Sandbox.

Meu sistema não está atualizando as cobranças do Asaas, o que pode ser?

Provavelmente você está com um problema de fila interrompida do seu Webhook. Isso acontece quando há alguma falha de comunicação da sua aplicação com o Asaas.

Confira a documentação de fila pausada para mais detalhes.

Minha chave de API não funciona

Certifique-se que você está utilizando a chave correta no ambiente correto. A documentação da nossa API redireciona todas as chamadas para Sandbox, para isso adicione um chave de Sandbox para teste.

Confira as URLs para chamadas da API para mais detalhes.

O Asaas tem White Label?

Sim. Você pode utilizar todas as funcionalidades do Asaas em uma organização de subcontas, utilizando o API como um motor de Bank as a Service.

Para ativar o White Label em Sandbox, você precisa entrar em contato com o suporte técnico e em produção alinhar com seu gerente de contas.

Saiba mais sobre o White Label.

Como posso desativar notificações do Asaas para meus clientes?

As notificações são configuradas para cada cliente. Você possui duas opções:

• Criar um cliente e enviar o campo notificationDisabled como true, dessa forma ele nunca receberá nenhuma notificação por padrão, ou;
• Habilitar ou desabilitar apenas algumas notificações, realizando uma configuração personalizada de notificações. Confira nosso guia de notificações.

O que significa o erro 403 com uma mensagem do Cloudfront?

Erros 403 em chamadas GET indicam que você está enviando um body junto da requisição. Você não deve enviar nenhuma informação no body em chamadas do tipo GET.