Integrações bancárias: qual banco faz o quê
O Hap conversa direto com a API de 10 bancos para emitir boleto, dar baixa automática e puxar extrato: Sicredi, Sicoob, Safra, C6 Bank, Cora, Bradesco, Inter, Santander, Caixa e Itaú. Este artigo mostra o que cada um suporta, como ligar a integração no convênio e o que fazer quando o boleto não registra.
Quando usar
Use ao escolher com qual banco integrar, ao ligar a cobrança pela primeira vez, ou quando quiser saber se um recurso (alteração de boleto, extrato, webhook) existe no seu banco antes de prometê-lo ao cliente.
Antes de começar
- Conta bancária já cadastrada em Financeiro > Contas Bancárias.
- Contrato de cobrança ativo no banco e as credenciais de API em mãos (cada banco entrega as suas de um jeito - veja o artigo do seu banco).
O que muda quando o banco é integrado
Sem integração, o boleto é gerado pelo Hap e você precisa enviar um arquivo de remessa ao banco e importar o retorno para dar baixa. Com a integração ligada, o Hap registra o título direto na API do banco no momento em que o boleto é criado, e a baixa chega sozinha quando o cliente paga.
| Recurso | Sicredi (748) | Sicoob (756) | Safra (422) | C6 Bank (336) | Cora (403) | Bradesco (237) | Inter (077) | Santander (033) | Caixa (104) | Itaú (341) |
|---|---|---|---|---|---|---|---|---|---|---|
| Emitir, consultar e baixar boleto | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim | Sim |
| Alterar boleto pela API | Sim | Sim | Sim | Sim | Não | Sim | Não | Sim | Sim | Sim |
| Extrato da conta pela API | Sim | Sim | Não | Sim | Sim | Sim | Sim | Sim | Não | Não |
| Baixa automática por webhook | Sim | Sim | Não | Sim | Sim | Sim | Sim | Sim | Não | Sim |
| Pix dinâmico (QR Code no caixa do PDV) | Sim | Não | Não | Sim | Sim | Sim | Sim | Sim | Não | Não |
Como ligar a integração
- 1
Em Financeiro > Contas Bancárias, edite a conta e abra a aba Convênios.
- 2
Marque Registro WebService?. É essa opção que manda o boleto pela API do banco - os campos de credencial só aparecem depois dela.
- 3
Preencha as credenciais do seu banco. Cada banco pede um conjunto diferente; o artigo do banco lista campo a campo.
- 4
Clique em Testar credenciais. O Hap faz uma chamada real na API do banco e mostra o erro exato, se houver. Faça isso antes de salvar.
- 5
Salve a conta. Nos bancos com webhook, é neste momento que o Hap registra a notificação de pagamento.
Quando alguma coisa não funciona
O botão Testar credenciais é o primeiro lugar a olhar: ele devolve a mensagem do próprio banco, que costuma apontar o campo errado ou o produto que falta contratar. Se o teste passa mas o boleto falha, abra a aba de logs da conta - cada chamada fica registrada com data, operação e a resposta do banco.
Problemas comuns
- O boleto sai sem registro no banco: confira se Registro WebService? está marcado no convênio. Sem essa opção o Hap não chama a API - o boleto segue pelo caminho antigo.
- Testar credenciais falha: a mensagem que aparece é a do próprio banco, não do Hap. Leia o texto: ele costuma dizer qual campo está errado ou qual produto não foi contratado.
- O boleto foi pago mas o título continua aberto: nos bancos sem webhook (Safra e Caixa) a baixa depende de consulta periódica e pode demorar alguns minutos. Nos demais, confira se o webhook foi registrado - ele é criado ao salvar a conta.
- Alteração de vencimento recusada: Cora e Inter não alteram boleto pela API. Nesses dois, cancele o título e emita um novo.
- Extrato não puxa mesmo com o boleto funcionando: extrato é outra integração, com credencial própria. Veja o artigo Boleto e extrato são integrações diferentes.