/ Central de Ajuda Criar conta grátis Todos os guias
Integração bancária · Autosserviço

Como integrar o Banco Inter PJ ao CredCoin

Conecte sua conta Inter Empresas PJ ao CredCoin pela API do banco. Solicite a integração no Internet Banking PJ e, após a análise e aprovação pelo Inter, cadastre as credenciais no sistema. A conclusão depende dessa aprovação.

Para quem administra a conta PJ Sujeito à aprovação do Inter Uma credencial por conta
Antes de começar

O que você vai precisar

Portal: Internet Banking PJ, em internetbanking.bancointer.com.br (ou o app empresarial). O login é confirmado por QR Code no app.

Pré-requisitos

  • Conta Inter Empresas PJ ativa. Segundo o Inter, as APIs não estão disponíveis para contas PF ou MEI.
  • Perfil que permite criar integrações (administrador da conta).
  • A chave PIX que a conta usa para receber (cobranças e PIX recebido).
O Inter é autosserviço. Você cria a integração no Internet Banking, o próprio banco gera o certificado e a chave, e tudo sai em uma única credencial. No fim, cada campo do sistema recebe um valor:
Campo no sistemaDe onde vemInter
Client IDtela da integração no portal✓
Client Secrettela 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 recebedorasua chave PIX da conta✓
Conta correntenº da contaopcional (só com +1 conta)

No portal do banco

1 · Criar a integração no portal

1
Acessar "Nova Integração"
Portal do banco

Faça login no Internet Banking PJ (confirmação por QR Code). Procure "Integrar" ou "Soluções para sua empresa" e clique em "Nova Integração". As fontes oficiais usam esses dois nomes de menu; siga a opção exibida na sua conta.

2
Nomear e selecionar a conta
Portal do banco

Dê um nome e uma descrição (ex.: CredCoin produção) e selecione a conta que será movimentada.

3
Marcar as permissões (escopos)
Portal do banco

Selecione os serviços necessários à integração do sistema, conforme os escopos abaixo:

  • 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 (webhook e webhook-banking, leitura e escrita)
  • Extrato (extrato, leitura)
Não libere serviços além dos necessários. Se os nomes no portal divergirem dos escopos acima, confirme com o suporte antes de concluir. Siga as confirmações solicitadas pelo banco, inclusive o código por SMS. O Inter analisa o pedido e pode solicitar um formulário antes da aprovação.
No portal do banco

2 · Baixar certificado, chave e credenciais

4
Baixar arquivos e copiar credenciais
Portal do banco

Após a aprovação, a integração aparece com status "Novo" em "Minhas Integrações". Na coluna "Ações", abra os três pontos e escolha "Download chave e certificado". Salve os arquivos e as credenciais:

  • Certificado (ex.: Inter API_Certificado.crt)
  • Chave privada (ex.: Inter API_Chave.key)
  • Client Id e Client Secret, exibidos na mesma tela
Os arquivos e as credenciais ficam disponíveis uma única vez. Salve-os em local seguro imediatamente. Proteja o Client Secret e a chave privada: não os envie em capturas de tela, mensagens de suporte ou locais públicos. Se perder os dados, o Inter orienta a criar uma nova integração.

Após salvar os dados, aguarde o processamento do banco e confirme o status "Ativo" antes de usar a integração.

No sistema CredCoin

3 · Cadastrar no sistema

5
Definir a integração da conta
No sistema

Abra a conta correspondente, defina Integração bancária → Banco Inter e salve.

6
Preencher as credenciais
No sistema

Na conta, clique em "Gerenciar credenciais" (/accounts/<id>/bank_credentials) e depois em "Editar credenciais". No bloco Credenciais, preencha:

  • Client ID → o Client Id do Inter
  • Client Secret → o Client Secret do 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.

Campos de segredo já salvos mostram "Cadastrado (deixe em branco para manter)". Para não sobrescrever um segredo, deixe o campo vazio.
No sistema CredCoin

4 · Registrar webhooks e ativar

7
Registrar os 3 webhooks
No sistema

A tela de credenciais mostra as 3 URLs de webhook desta conta (PIX, Cobrança e Banking). O suporte registra essas URLs no banco. 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.

O Inter aceita apenas um webhook por tipo por chave PIX. Se você tem ambientes de teste e produção, use chaves PIX diferentes em cada um. Senão, um sobrescreve o callback do outro.
8
Validar e ativar em produção
No sistema

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.

Não esqueça

Renovação do certificado

O certificado do Inter tem validade de 1 ano. O sistema avisa quando faltam 60 dias. O Inter orienta a renovar o certificado ou a gerar uma nova integração. Se você criar uma Nova Integração (passos 1 a 4), cadastre juntos os quatro valores dela: Client ID, Client Secret, Certificado e Chave privada. Campos de segredo vazios mantêm os valores antigos; não deixe o ID e o Secret antigos com os arquivos da nova integração. Depois, confirme com o suporte o registro dos webhooks e a validação da integração.
Apêndice

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.
Referências

Fontes oficiais

Sistema de controle de empréstimos e crediário. Grátis até 10 clientes com contrato em aberto.