O que você vai precisar
Portal: Internet Banking PJ — internetbanking.bancointer.com.br (ou o app empresarial). O login é confirmado por QR Code no app.
Pré-requisitos
- Conta PJ ativa no Banco Inter.
- Perfil que permite criar integrações (administrador da conta).
- A chave PIX que a conta usa para receber (cobranças e PIX recebido).
| Campo no sistema | De onde vem | Inter |
|---|---|---|
| Client ID | tela da integração no portal | ✓ |
| Client Secret | tela da integração no portal | ✓ (aparece 1 vez) |
| Certificado (PEM) | arquivo .crt baixado do banco | ✓ |
| Chave privada (PEM) | arquivo .key baixado do banco | ✓ (banco gera) |
| Chave PIX recebedora | sua chave PIX da conta | ✓ |
| Conta corrente | nº da conta | opcional (só com +1 conta) |
1 · Criar a integração no portal
Faça login no Internet Banking PJ (confirmação por QR Code). No menu, vá em "Soluções para sua empresa" e clique em "Nova Integração".
Dê um nome e uma descrição (ex.: CredCoin — produção) e selecione a conta que será movimentada.
Para o sistema funcionar por completo, habilite tudo relacionado a:
- Cobrança / Boletos (
boleto-cobranca— leitura e escrita) - Cobrança PIX (
cob,cobv,pix— leitura e escrita) - Pagamento PIX (
pagamento-pix— leitura e escrita) - Webhooks (
webhookewebhook-banking— leitura e escrita) - Extrato (
extrato— leitura)
2 · Baixar certificado, chave e credenciais
Na tela de detalhes da integração você baixa dois arquivos PEM e copia as credenciais:
- Certificado — ex.:
Inter API_Certificado.crt - Chave privada — ex.:
Inter API_Chave.key - Client Id e Client Secret — exibidos na mesma tela
Depois, ative a integração no portal. O status passa por uma validação e, após alguns minutos, fica "Ativo" — só então ela funciona.
3 · Cadastrar no sistema
Abra a conta correspondente, defina Integração bancária → Banco Inter e salve.
Em "Gerenciar credenciais" da conta (/accounts/<id>/bank_credentials), no bloco Credenciais, preencha:
- Client ID → o
Client Iddo Inter - Client Secret → o
Client Secretdo Inter - Certificado (PEM) → conteúdo do
.crt(enviar o arquivo ou colar o texto) - Chave privada (PEM) → conteúdo do
.key - Chave PIX recebedora → a chave PIX da conta
- Conta corrente → deixe em branco, exceto se a integração foi criada com mais de uma conta
Mantenha Credencial ativa marcada e clique em Salvar credenciais.
4 · Registrar webhooks e ativar
A tela de credenciais mostra as 3 URLs de webhook desta conta (PIX, Cobrança e Banking). O registro delas no banco é feito pelo administrador da plataforma — depois de salvar as credenciais, avise o suporte para concluir o registro. Se preferir, você mesmo pode cadastrar as URLs manualmente no portal do Inter.
Faça uma cobrança/PIX de teste. Na conta, marque Integração ativada (em produção) — só então o sistema passa a conferir os pagamentos direto no banco.
Renovação do certificado
Dúvidas comuns
- Client ID / Client Secret
- Identificador e "senha" da aplicação. O Secret aparece uma vez — copie na hora.
- Certificado (PEM) / Chave privada (PEM)
- Par usado no mTLS (canal seguro com o banco). PEM é texto começando com
-----BEGIN ...-----. O sistema aceita colar o texto ou enviar o arquivo (.pem,.crt,.cer,.key,.txt, até 64 KB). - Chave PIX recebedora
- A chave PIX pela qual a conta recebe (cobranças e PIX recebido).
- "Cadastrado (deixe em branco para manter)"
- O segredo já está salvo; deixe o campo vazio para não sobrescrevê-lo.
- Webhook do Inter sobrescrito
- É um por tipo por chave PIX — use chaves diferentes entre teste e produção.