Chaves de API Pessoais (Usuário Comum / Pessoa Física)
Se você é um usuário final cadastrado e deseja automatizar as ações da sua própria conta de forma programática (como criar scripts de automação, conciliação financeira pessoal ou conectar a sistemas externos), você pode gerar suas próprias chaves de acesso.
Regra de Ouro: Isolamento Total
As chaves geradas por você são de uso pessoal e privado:
-
Elas dão acesso apenas ao seu próprio saldo e dados.
-
Elas não dão acesso ao tesouro ou dados de qualquer empresa parceira (participante).
-
O participante/empresa desenvolvedora da carteira que você usa não tem acesso a essas credenciais.
Como Gerar Suas Credenciais
Você pode gerar seu par de Client ID e Client Secret pessoal sem precisar escrever código:
-
No Computador (Desktop): Acesse Integrações → API e clique em Gerar API Key.
-
No Celular (PWA): Toque em ⚙️ Configurações → Integrações → API e clique em Gerar API Key.
⚠️ Atenção: Guarde o seu Client Secret em local seguro imediatamente. Por motivos de segurança, ele nunca será exibido novamente.
Como Usar Suas Chaves em Automações
-
Gere seu token de acesso (JWT): Faça uma chamada contendo suas chaves pessoais para
POST /v1/auth/api-key. Veja como fazer o cache e renovação do token em Autenticação. -
Execute chamadas autenticadas: Adicione o token recebido no cabeçalho
Authorization: Bearer <token>das suas requisições para operar sua conta pessoal.
📚 Guia de Operações: Veja a tabela de precisão de casas decimais e como montar chamadas de Pix e Swap em Operações Financeiras.

