Authorization:
Escopos
Passkeys e biometria podem ser cadastradas em Configurações > Segurança para entrar no painel e confirmar saques no lugar do aplicativo autenticador. O dispositivo pode solicitar biometria ou PIN. Essas confirmações pertencem às rotas privadas de sessão do painel; não substituem a chave Bearer e não adicionam permissões ao SDK/API comercial. KYC e demais controles do saque continuam obrigatórios. Outras ações que exigem TOTP mantêm essa exigência.
Use uma chave separada por serviço e ambiente. Conceda somente os escopos necessários, configure expiração e restrição de IP quando aplicável.
Respostas de autenticação
401 invalid_api_key indica token ausente, inválido, expirado, revogado ou bloqueado pela lista de IPs. 403 insufficient_scope indica uma chave válida sem o escopo exigido pela rota.
Organizações suspensas (restricted) ou encerradas (closed) recebem 403 organization_not_active em chamadas autenticadas por chave, tanto no sandbox quanto em produção. Uma chave válida não remove a suspensão; corrija a situação da conta antes de tentar novamente.