Conectar Banco Inter

⏱ Tempo estimado: 15-20 minutos

O Banco Inter usa autenticação OAuth2 com certificado mTLS, similar ao Efí. Disponível apenas para contas PJ.

⚠️A API do Banco Inter só está disponível para contas PJ (empresa). Se você tem apenas conta PF no Inter, escolha outro PSP.

Abrir conta PJ no Inter

Acesse inter.co/empresas
Abra uma conta PJ (exige CNPJ)
Complete a verificação

Cadastrar chave Pix

No Internet Banking Inter, vá em Pix → Minhas Chaves
Cadastre uma chave Pix (CNPJ, email, telefone ou aleatória)
Copie e guarde a chave — você vai precisar dela no Hubpay

Criar aplicação e obter credenciais

No Internet Banking, vá em API ou Desenvolvedor
Clique em Nova Aplicação
Dê um nome (ex: "Hubpay")
Selecione os escopos:
- cob.write (criar cobranças)
- cob.read (consultar cobranças)
- pix.read (consultar Pix recebidos)
- pix.write (enviar Pix — opcional)
- webhook.write (configurar webhooks)
- webhook.read (consultar webhooks)
Copie o Client ID e Client Secret

Baixar certificado

Na mesma tela da aplicação, clique em Baixar certificado ou Exportar chaves
Será baixado um arquivo ZIP contendo:
- Um arquivo .crt (certificado)
- Um arquivo .key (chave privada)
Abra ambos os arquivos com um editor de texto
Copie o conteúdo de cada um

⚠️Certificados do Inter expiram após 1 ano. Quando expirar, gere novo certificado e atualize no Hubpay.

Conectar no Hubpay

Acesse hubpay.dev/dashboard/psps
Clique em Conectar novo PSP
Selecione Banco Inter
Selecione o ambiente:
- Test = sandbox
- Live = produção
Preencha:
- Client ID: cole o Client ID da aplicação
- Client Secret: cole o Client Secret
- Chave Pix: cole a chave Pix cadastrada
- Certificado (.crt): cole o conteúdo completo do arquivo .crt
- Chave Privada (.key): cole o conteúdo completo do arquivo .key
Clique em Salvar credencial

💡🔒 Suas credenciais e certificado são criptografados com AES-256-GCM antes de serem armazenados.

Configurar webhook

Após salvar, siga as instruções na tela do dashboard pra configurar o webhook no Internet Banking do Inter. O Banco Inter segue o padrão Pix do Banco Central, enviando notificações de Pix recebidos vinculados à chave Pix configurada.

Testar

bash

curl -X POST https://api.hubpay.dev/v1/charges \
  -H "Authorization: Bearer hpx_test_SUA_CHAVE_HUBPAY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "provider": "inter",
    "description": "Teste Banco Inter"
  }'

Solução de problemas

Erro	Causa	Solução
`502` com "SSL" ou "certificate"	Certificado inválido ou não corresponde	Confirme que colou o conteúdo correto do `.crt` e `.key`. Não troque os dois.
`502` com "OAuth error 401"	Client ID ou Secret incorretos	Verifique no Internet Banking do Inter se as credenciais estão corretas.
`502` com "chave Pix inválida"	Chave não cadastrada ou inativa	Cadastre ou ative uma chave Pix na conta Inter.
Certificado expirado	Certificados do Inter expiram após 1 ano	Gere novo certificado e atualize no Hubpay.
"Conta não é PJ"	API do Inter só pra PJ	Abra conta empresarial no Inter.

Diferença entre Banco Inter e Efí (ambos usam mTLS)

Aspecto	Efí	Banco Inter
Certificado	`.p12` convertido pra `.pem` (cert + key juntos)	`.crt` + `.key` separados
OAuth URL	pix-h.api.efipay.com.br/oauth/token	cdpj-sandbox.partners.uatinter.co/oauth/v2/token
OAuth body	JSON	x-www-form-urlencoded
API Pix	Padrão BCB (`/v2/cob/{txid}`)	Padrão BCB (`/pix/v2/cob/{txid}`)
Conta	PF e PJ	Somente PJ