Banco Inter (077): BolePix nativo, extrato e pagamentos
O Inter é a integração mais simples do Hap: as credenciais e o certificado saem prontos do próprio Internet Banking, todo boleto já nasce com QR Code Pix sem precisar marcar nada, e é o único banco que entrega o PDF do boleto direto pela API. Este artigo mostra como criar a integração e o que ele não faz.
Quando usar
Use ao configurar a conta Inter pela primeira vez, ou quando precisar alterar um boleto e o sistema recusar.
Antes de começar
- Acesso ao Internet Banking do Inter PJ, com permissão para criar integrações.
- Conta Inter cadastrada no Hap.
Por que o Inter é o mais simples
No Inter você não precisa pedir credencial a gerente nem esperar aprovação de portal: entra no Internet Banking PJ, cria a integração e o próprio banco gera o certificado e as credenciais na hora. E o boleto já nasce com QR Code Pix, sem opção para marcar.
| Recurso | Como funciona |
|---|---|
| Boleto com Pix | Todo boleto já sai com código de barras e QR Code Pix. Não há opção a marcar. |
| PDF do boleto | Baixado direto da API do banco - o Inter é o único que entrega o PDF assim. |
| Pix | Cobrança imediata e com vencimento, QR Code e devolução. |
| Pagamentos | Pagamento de boleto e envio de Pix, em uma única chamada. |
| Extrato e saldo | Sim, sem limite de janela. |
| Webhook | Registrado sozinho ao salvar a conta. |
| Alterar boleto | Não. Para mudar valor ou vencimento, cancele e emita outro. |
Criar a integração no Internet Banking
- 1
No Internet Banking do Inter PJ, abra Soluções para sua empresa.
- 2
Clique em Nova Integração para criar a aplicação.
- 3
O Inter gera automaticamente o certificado e as credenciais. Baixe os arquivos .crt e .key.
- 4
Ative a integração e selecione os escopos: boleto, Pix, extrato e pagamentos, conforme o que for usar.
Preencher o convênio no Hap
| Campo no formulário | O que preencher |
|---|---|
| Client ID (obrigatório) | Gerado no Internet Banking do Inter PJ. |
| Client Secret (obrigatório) | Gerado junto com o certificado. |
| Ambiente (obrigatório) | Sandbox ou Produção. |
| Arquivo .crt (obrigatório) | O certificado gerado pelo Inter. |
| Arquivo .key (obrigatório) | A chave privada do certificado gerado pelo Inter. |
| Senha do certificado | Apenas se a chave tiver senha. |
Problemas comuns
- Não encontro o checkbox Boleto híbrido para o Inter: ele não existe aqui. No Inter todo boleto já sai com QR Code Pix automaticamente.
- Não consigo alterar o valor ou o vencimento de um boleto: o Inter não expõe alteração na API. Cancele o boleto e emita outro.
- Uma operação é recusada por falta de permissão: confira os escopos da integração no Internet Banking. Eles são selecionados na criação e precisam cobrir o que você usa - boleto, Pix, extrato ou pagamentos.
- O certificado venceu: gere uma nova integração no Internet Banking e substitua os arquivos .crt e .key no convênio.