Banco Inter API Skill

Português (Brasil) · English

Integre Pix, boleto, Banking e webhooks do Banco Inter usando ChatGPT, Codex ou Claude Code com contexto técnico pronto.

Skill open source e não oficial para ajudar agentes de código a implementar, revisar e depurar integrações com as APIs do Banco Inter Empresas sem precisar redescobrir toda a documentação a cada tarefa.

Projeto não oficial. Este repositório não é afiliado, endossado nem mantido pelo Banco Inter. Sempre valide alterações sensíveis de produção na documentação oficial em developers.inter.co.

Em 60 segundos

1. Instale a Skill no seu agente preferido.
2. Abra o projeto em que você quer integrar o Inter.
3. Peça para o agente usar a Skill antes de implementar.

Use a Banco Inter API Skill e implemente a integração Pix deste projeto
seguindo o contrato atual documentado, com OAuth 2.0 + mTLS e tratamento de erros.

Atalhos: ChatGPT · Codex · Claude Code · Exemplos · Roadmap

Para quem é

• desenvolvedores brasileiros;
• pessoas construindo SaaS com vibe coding;
• indie hackers e makers;
• equipes integrando Pix, cobrança, Banking e webhooks;
• projetos que usam ChatGPT, Codex, Claude Code ou outros clientes compatíveis com Agent Skills.

O que a Skill cobre

• ⚡ Pix e Pix Automático;
• 🧾 Cobrança / Boleto com Pix V3;
• 🏦 Banking, saldo, extrato e pagamentos;
• 🔔 Webhooks e callbacks;
• 🔐 OAuth 2.0 + mTLS, certificados e scopes;
• 🧪 Sandbox e Postman;
• 📄 CNAB/VAN;
• 🏠 Crédito Empresas e Crédito Imobiliário;
• 🧰 erros, troubleshooting, migrações e changelog.

Início rápido

ChatGPT

1. Baixe banco-inter-api-skill-vX.Y.Z.zip na página de Releases.
2. Em uma conta/workspace elegível, abra Plugins → Skills → Criar → Enviar do seu computador.
3. Revise o conteúdo e instale a Skill.

As Skills da OpenAI seguem o padrão aberto Agent Skills. Um repositório do GitHub não vira automaticamente uma listagem pública no Diretório de Plugins do ChatGPT.

Codex

A distribuição inclui plugins/banco-inter-api/.codex-plugin/plugin.json, skills/ e um marketplace local em .agents/plugins/marketplace.json.

git clone https://github.com/whyrnld/banco-inter-api-skill.git
cd banco-inter-api-skill
codex plugin marketplace add "$PWD"
codex plugin add banco-inter-api@banco-inter-api-community

Claude Code

/plugin marketplace add whyrnld/banco-inter-api-skill
/plugin install banco-inter-api@banco-inter-api-community
/reload-plugins

Também é possível usar a Skill standalone em ~/.claude/skills/banco-inter-api/ ou .claude/skills/banco-inter-api/.

Veja o guia completo em docs/INSTALLATION.md.

Exemplos para vibe coding

Depois de instalar a Skill, experimente prompts como:

Use a Banco Inter API Skill e implemente uma cobrança Pix com vencimento,
persistindo o txid e atualizando o status pelo webhook.

Analise este erro 401 da API do Inter. Verifique mTLS, token, scope,
certificado e headers antes de sugerir uma correção.

Migre esta integração legada de boleto para Cobrança Boleto com Pix V3,
preservando o fluxo assíncrono e os callbacks atuais.

Há exemplos executáveis e sem dependências externas em examples/, incluindo Node.js, Python e um receiver de webhook local.

Cobertura auditada

• Auditoria: 19/08/2026
• Fontes/assets oficiais inventariados: 164
• Entradas datadas do changelog revisadas individualmente: 74/74
• Descoberta e coleta: Firecrawl map, sitemap e leitura das páginas oficiais encontradas
• Rotas autenticadas/dinâmicas: registradas com o comportamento observado, sem presumir conteúdo privado

A matriz de cobertura está em docs/COVERAGE.md. A trilha completa de fontes está em references/00-source-index.md e sources.json.

Como o conhecimento é organizado

O SKILL.md contém as regras centrais e o roteamento. O agente carrega os arquivos menores de references/ conforme a necessidade.

banco-inter-api-skill/
├── SKILL.md
├── references/
├── plugins/banco-inter-api/
├── .agents/plugins/marketplace.json
├── .claude-plugin/marketplace.json
├── docs/
├── examples/
├── evals/
├── scripts/
├── ROADMAP.md
├── README.md
├── README.en-US.md
└── sources.json

A raiz (SKILL.md + references/) é a fonte canônica. Após alterar a Skill ou as referências, execute:

python3 scripts/sync_plugin_bundle.py
python3 scripts/validate_skill.py

Qualidade e validação

O projeto mantém:

• validação estrutural própria;
• verificação de sincronização entre a Skill canônica e o bundle de plugins;
• validação do formato Agent Skills com skills-ref no CI;
• checagem conservadora para evitar commit acidental de chaves privadas e segredos;
• casos de avaliação em evals/ para comportamentos críticos.

Idioma

pt-BR é o idioma canônico do projeto. A documentação voltada a pessoas possui tradução secundária em inglês. Identificadores técnicos — endpoints, headers, scopes, enums e nomes de campos — são preservados exatamente como aparecem na API.

Atualizando o snapshot

1. Execute um novo inventário do portal oficial.
2. Compare as URLs com sources.json.
3. Leia toda URL nova ou alterada.
4. Revalide contratos atuais antes de atualizar endpoints, scopes ou payloads.
5. Leia individualmente novas entradas do changelog.
6. Atualize snapshot_date, referências e CHANGELOG.md.
7. Preserve divergências da documentação como notas; não escolha silenciosamente uma interpretação.
8. Execute python3 scripts/sync_plugin_bundle.py e python3 scripts/validate_skill.py.

Contribuindo

Contribuições baseadas em fontes oficiais são muito bem-vindas. Consulte CONTRIBUTING.md, o CODE_OF_CONDUCT.md e o ROADMAP.md.

Licença e direitos de terceiros

O conteúdo original deste projeto está sob a Licença MIT. Isso não relicencia documentação, SDKs, manuais, marcas, logotipos ou outros materiais do Banco Inter ou de terceiros. Consulte THIRD_PARTY_NOTICES.md.