Erro “IP não autorizado” ao realizar saques via API
Quando este artigo se aplica?
Este artigo se aplica somente quando um produtor está tentando criar uma transferência ou saque via API e recebe uma mensagem indicando que o IP não está autorizado.
Antes de orientar o produtor, confirme exatamente:
Qual endpoint está sendo utilizado;
Qual operação está sendo realizada;
Em qual momento o erro acontece;
Qual mensagem completa foi retornada pela API.
Existem outros cenários envolvendo IPs na plataforma. Por isso, não assuma que todo erro relacionado a IP corresponde à configuração da API de saques.
O que causa esse erro?
Por segurança, a API de saques aceita requisições apenas de servidores previamente autorizados pelo produtor.
Quando uma requisição parte de um IP que não está cadastrado na conta, a API bloqueia a operação e retorna o erro de IP não autorizado.
Essa proteção reduz o risco de alguém utilizar indevidamente as credenciais da API para realizar transferências.
Como resolver?
O produtor deve cadastrar o IP público do servidor responsável pelas requisições.
No painel do produtor, acesse:
Integrações → API → IPs autorizados
Adicione o IP público de saída do servidor utilizado na integração e salve a configuração.
Após isso, novas requisições de saque realizadas a partir desse IP poderão ser autorizadas.
Qual IP deve ser cadastrado?
Deve ser cadastrado o IP público de saída do servidor que envia a requisição para a API.
Não deve ser utilizado:
IP privado, como
192.168.x.x;IP do computador do desenvolvedor, quando a aplicação roda em um servidor;
IP de entrada do servidor, caso ele utilize outro IP para conexões de saída.
Se a aplicação usa múltiplos servidores, proxies ou serviços com saída variável, todos os IPs necessários devem ser cadastrados.
Informações obrigatórias para análise
Ao solicitar ajuda ao suporte, o produtor deve encaminhar:
Payload completo da requisição enviada para a API;
Retorno completo da API, incluindo código HTTP e corpo da resposta;
Endpoint utilizado;
Data e horário aproximados da tentativa;
IP público cadastrado;
IP público de saída identificado pelo servidor.
Essas informações são essenciais para confirmar se o problema realmente está relacionado à autorização de IP ou se existe outro erro na requisição.
Atenção às credenciais
Antes de compartilhar o payload, remova ou oculte dados sensíveis, como:
x-secret-key;x-public-key, quando necessário;Tokens;
Dados completos de cartão;
Outras credenciais privadas.
Não envie apenas uma descrição como “está dando IP não autorizado”. Sem o payload e o retorno completo, a análise pode seguir para o fluxo errado.
Diferencie este erro de outros cenários
Configuração de contas, split ou subcontas nas adquirentes
Se o problema estiver relacionado à criação ou configuração de contas dentro de uma adquirente, este artigo não se aplica.
Consulte o artigo:
Configuração de contas Split/Subcontas nas adquirentes
Liberação de IPs em whitelist pelas adquirentes
Se uma adquirente estiver solicitando os IPs da plataforma para adicionar em sua própria whitelist, este artigo também não se aplica.
Consulte o artigo:
IPs para liberação em whitelist, integração com adquirentes
A autorização de IP da API de saques é feita pelo próprio produtor em sua conta. Já a whitelist de adquirente envolve a comunicação entre a plataforma e a adquirente.
Cadastrei o IP, mas o erro continua
Verifique:
Se o IP cadastrado é realmente o IP público de saída;
Se a aplicação está executando no servidor esperado;
Se existe proxy, NAT, balanceador ou serviço intermediário;
Se o provedor altera o IP de saída dinamicamente;
Se a requisição está sendo feita para o endpoint correto;
Se o erro retornado ainda é realmente “IP não autorizado”.
Depois dessas verificações, envie ao suporte o payload completo e o retorno integral da API, com as credenciais sensíveis ocultadas.
Resumo
Quando o erro “IP não autorizado” ocorrer ao realizar um saque via API:
Confirme que a operação é realmente um saque via API;
Cadastre o IP público do servidor em Integrações → API → IPs autorizados;
Repita a requisição;
Caso o erro persista, envie o payload completo e o retorno completo da API ao suporte.
Perfil: Produtor
Categoria: API • Transferências e saques