IP Fixo para Integrações de API: Whitelist em Asaas, Pagar.me e Gateways

Serviços como Asaas e Pagar.me registram no painel deles uma lista de IPs autorizados a usar a chave de API. Qualquer requisição de um IP fora dessa lista é rejeitada antes mesmo de validar a chave — a Asaas devolve HTTP 403, a Pagar.me devolve 401.

O problema aparece quando a aplicação não tem um IP de saída fixo. Hospedagem serverless, containers que sobem e descem, e a maioria dos planos de nuvem usam um pool de IPs compartilhado — a chamada de hoje pode sair de um endereço diferente da de ontem. A própria documentação da Asaas recomenda, para esse caso, usar "um serviço de NAT Gateway com IP de saída estático" antes de cadastrar o IP na whitelist. É exatamente essa função que este plano cumpre.

É o mesmo IP ISP dedicado do plano usado em contas de Ads — registrado em provedor de internet, fixo e exclusivo — só que vendido com a rotação técnica automática desligada. Sua aplicação se conecta na internet através deste IP (HTTP ou SOCKS5) antes de chamar a API do gateway, e a chamada final sai sempre do mesmo endereço.

O proxy funciona com usuário e senha, igual a qualquer proxy HTTP/SOCKS5 — a diferença é só onde ele entra no seu código:

• Node.js: crie um agente de proxy (https-proxy-agent ou similar) com a URL http://usuário:senha@host:porta e passe ele na chamada HTTP para a API do gateway.
• PHP: com cURL, defina CURLOPT_PROXY como host:porta e CURLOPT_PROXYUSERPWD como usuário:senha antes de curl_exec.
• Python: passe proxies={'https': 'http://usuário:senha@host:porta'} na chamada da biblioteca HTTP usada.

A credencial completa, em todos esses formatos prontos para copiar, fica em Meus proxies depois da entrega.

• Asaas: menu do usuário → Integrações → Mecanismos de Segurança → Whitelist de IPs.
• Pagar.me: configurações da conta/loja no Dash → IP Allowlist.

Cadastre o IP fixo entregue por este plano nessa lista, aponte as chamadas de API pelo proxy, e a origem bate com o que o gateway espera.

No plano de Ads normal, se um teste técnico mostra o IP fora do ar, ele é trocado automaticamente — faz sentido lá, porque o objetivo é manter a conta funcionando com qualquer IP saudável. Aqui o objetivo é o oposto: o valor do produto é o endereço em si, porque é ele que está cadastrado na whitelist do seu gateway. Uma troca automática deixaria a whitelist com o IP errado sem ninguém perceber até a próxima chamada falhar. Por isso, tanto o botão "não funciona" quanto o reteste automático da entrega ficam desligados para este plano — se o IP realmente parar de responder, é troca manual, por ticket, com você sabendo exatamente quando o endereço muda.

A exceção que não depende da ProxyBox: o provedor da rede pode substituir o endereço ou a credencial durante a vigência. O sistema confere a cada 15 minutos; se isso acontecer, o painel passa a mostrar o novo endereço e você recebe um e-mail avisando, para atualizar a whitelist do gateway.

• Conta de anúncio, rede social ou perfil — use o ISP residencial normal, que troca automaticamente se o IP cair.
• Coleta de dados em volume — um IP fixo concentra requisições; o residencial rotativo entrega mais por real.
• Você não sabe se o seu IP de saída já é fixo — hospedagens com IP dedicado próprio (VPS com IP fixo, por exemplo) não precisam deste plano; ele existe para quando o ambiente não garante isso sozinho.

1. Compre o plano. Pagamento por PIX, liberação automática.
2. Copie a credencial em Meus proxies — o card mostra o selo "IP travado".
3. Configure o proxy na sua aplicação, apontando as chamadas de API pelo endereço entregue.
4. Cadastre o mesmo IP na whitelist do gateway (Asaas, Pagar.me ou outro que exija IP fixo).
5. Teste uma chamada real antes de colocar em produção.