inter-pj
CLI em Rust para acessar a sua conta PJ do Inter Empresas pela linha de comando, usando as APIs oficiais do Inter (OAuth2 + mTLS).
Projeto não oficial. Não tem vínculo com o Banco Inter. Use por sua conta e risco e comece pelo ambiente sandbox.
Documentação: https://edusouza.github.io/inter-pj-cli/ (instalação, guias, referência de comandos e arquitetura).
$ inter-pj saldo
Saldo disponível R$ 2.850,55
Bloqueado em cheque R$ 240,25
Bloqueado judicialmente R$ 510,35
Bloqueado administrativo R$ 0,00
Limite R$ 1.000,00
$ inter-pj saldo --json | jq .disponivel
2850.55
$ inter-pj extrato --inicio 2026-08-01 --fim 2026-08-31
Extrato de 01/08/2026 a 31/08/2026
Data Tipo Descrição Valor
03/08/2026 Pix Pix recebido · Cliente Exemplo Ltda R$ 1.500,00
05/08/2026 Pagamento Pagamento efetuado · Boleto; energia -R$ 250,10
Entradas R$ 1.500,00
Saídas -R$ 250,10
Resultado do período R$ 1.249,90
2 transações
O que já funciona
| Versão | Funcionalidades |
|---|
| 0.1.0 | Autenticação OAuth2 com mTLS e cache de token · saldo · auth token/auth limpar · config init/caminho/mostrar |
| 0.1.1 | config verificar [--corrigir]: confere o arquivo de configuração e o perfil e corrige caminhos do Windows entre aspas duplas |
| 0.2.0 | extrato · extrato completo (detalhes, filtros, todas as páginas e modo scroll) · extrato pdf · saída CSV · retentativas automáticas |
| 0.3.0 | pix enviar (chave, copia e cola ou dados bancários) com resumo, confirmação, simulação, idempotência e limite por operação · pix consultar (com --aguardar) |
| 0.4.0 | pagamento boleto pagar (boletos, contas e tributos pelo código, conferido localmente) · boleto listar/cancelar · pagamento darf pagar/listar · pagamento lote enviar (JSON ou planilha CSV), consultar e modelo · os trilhos de segurança do Pix |
| 0.5.0 | cobranca emitir (pelas opções ou por arquivo JSON, com modelo) com resumo, confirmação e --aguardar · cobranca consultar com o QR Code do Pix no terminal ou em PNG · cobranca pdf · cobranca listar/sumario · cobranca cancelar/editar/edicao · cobranca pagar no sandbox |
| 0.6.0 | pix cob e pix cobv (cobranças Pix imediatas e com vencimento, com multa, juros e descontos): criar, com um txid que torna segura a repetição, revisar, consultar com o QR Code e listar; pix cobv também por arquivo, com modelo · pix recebidos · pix devolucao com os trilhos de segurança do Pix · pix loc · pix lote-cobv (JSON ou planilha CSV) · pagamentos no sandbox |
| 0.6.1 | conta: banco, agência e conta, das chaves numero_conta e digito_conta do perfil, sem chamar a API |
| 0.6.2 | extrato --formato ofx e extrato completo --todas-paginas --formato ofx: o extrato em OFX 1.02, com a conta do perfil, o saldo do fim do período e um FITID estável por transação |
O plano completo — webhooks e Pix Automático — está em docs/roadmap.md e é acompanhado pelas issues do projeto.
Instalação
Binários prontos: baixe o pacote do seu sistema na página de releases (Linux x86_64 glibc/musl, macOS Apple Silicon/Intel e Windows), confira o SHA256SUMS e coloque o inter-pj no seu PATH.
Com Cargo (Rust 1.88 ou superior):
$ cargo install --locked --git https://github.com/edusouza/inter-pj-cli --tag v0.6.2 inter-pj-cli
Configuração
1. Crie a integração no Internet Banking PJ
No Internet Banking do Inter Empresas, crie uma integração com os escopos que você vai usar (para saldo e extrato: extrato.read) e baixe:
- o certificado (
.crt) e a chave privada (.key);
- o client_id e o client_secret (o segredo só é mostrado uma vez).
Guarde esses arquivos fora de qualquer repositório, com permissão restrita (chmod 600).
2. Crie o arquivo de configuração
$ inter-pj config init
Arquivo de configuração criado em /home/voce/.config/inter-pj/config.toml
Edite o perfil criado:
perfil_padrao = "padrao"
[perfis.padrao]
ambiente = "sandbox" # ou "producao"
client_id = "<seu client_id>"
certificado = '~/inter/certificado.crt'
chave_privada = '~/inter/chave.key'
# conta_corrente = "<numero>" # só se a integração tiver mais de uma conta
# numero_conta = "<numero>" # opcional: número da conta, sem o dígito (`conta` e OFX)
# digito_conta = "<digito>" # opcional: dígito verificador da conta
# escopos = ["extrato.read"] # opcional: escopos pedidos em todo token
# limite_por_operacao = "1.000,00" # opcional: valor máximo de cada Pix ou pagamento
Escreva os caminhos entre aspas simples, principalmente no Windows (certificado = 'C:\inter\certificado.crt'). Entre aspas duplas, a barra invertida começa um escape do TOML. "C:\Users\..." impede a leitura do arquivo (\U pede 8 dígitos hexadecimais). Já "C:\novo\teste.crt" é lido, mas com uma quebra de linha e uma tabulação no lugar de \n e \t. Caminhos relativos são relativos ao arquivo de configuração, e ~/ é a sua pasta pessoal.
3. Informe o segredo pela variável de ambiente
$ export INTER_CLIENT_SECRET='<seu client_secret>'
$ inter-pj config verificar # confere o arquivo, o perfil, o certificado e a chave
$ inter-pj config mostrar # mostra a configuração efetiva (segredos ocultos)
$ inter-pj saldo
This is the beginning of the README. Read the rest at the original. Read the full README ↗
