Pular para o conteúdo
Menu da documentação

Erros

ip_not_allowed

HTTP 403 · IP não autorizado

HTTP 403
title IP não autorizado
detail O IP {ip} não está na allowlist do tenant.

Quando acontece: o token é válido, mas a requisição saiu de um IP fora da lista de IPs permitidos do tenant. Lista vazia bloqueia tudo.

O que fazer: cadastre no painel, em "Acesso à API", o IP de saída do seu servidor (ou a faixa CIDR) que aparece no detail. Atenção ao IP de saída real: NAT, proxy e balanceador mudam o IP que chega ao Pagaki.

Exemplo da resposta

application/problem+json
{
    "type": "https://sandbox.pagaki.com.br/errors/ip_not_allowed",
    "title": "IP não autorizado",
    "status": 403,
    "code": "ip_not_allowed",
    "detail": "O IP `{ip}` não está na allowlist do tenant.",
    "request_id": "01JBZ3Q2W5E8R1T4Y7K0M3N6P9"
}

Decida pelo code, que é estável; o detail pode mudar de texto. Guarde o request_id para falar com o suporte. Todos os erros.