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

  1. 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.

  2. 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.