C6 Bank (336): boleto, Pix, extrato e pagamentos
Como ligar a conta C6 Bank no Hap: as duas camadas de autenticação (certificado mTLS mais Client ID e Secret), o upload dos arquivos .crt e .key, a janela de 30 dias do extrato, o horário do sandbox e a aprovação manual que os pagamentos exigem no internet banking.
Quando usar
Use ao configurar a conta C6 pela primeira vez, quando o certificado for recusado, ou quando um lote de pagamentos ficar parado esperando aprovação.
Antes de começar
- Acesso ao C6 BaaS solicitado pelo portal de desenvolvedores ou pelo gerente PJ.
- Par de certificados .crt e .key entregue pelo C6, de preferência com a chave sem senha.
O que essa integração faz
O C6 Bank é uma das integrações mais completas do Hap: além do boleto, cobre Pix (cobrança imediata e com vencimento, e devolução), extrato da conta corrente e pagamentos em lote. Os webhooks de boleto, Pix e pagamentos são registrados sozinhos ao salvar a conta.
| Recurso | Como funciona |
|---|---|
| Boleto | Emitir, consultar, alterar e cancelar pela API. |
| Pix | Cobrança imediata e com vencimento, além de devolução. |
| Extrato | Sim, com janela máxima de 30 dias por consulta. |
| Pagamentos | Em lote, mas exigem aprovação manual no internet banking do C6. |
| Webhook | Registrado sozinho ao salvar a conta, para boleto, Pix e pagamentos. |
Antes de começar: o que pedir ao C6
- 1
Solicite o acesso ao C6 BaaS pelo portal de desenvolvedores ou pelo seu gerente PJ.
- 2
O C6 entrega o Client ID, o Client Secret e um par de certificados: um arquivo .crt e um arquivo .key.
- 3
Se o .key vier protegido por senha, gere uma versão sem senha antes de cadastrar - é o formato que menos dá problema.
Preencher o convênio no Hap
| Campo no formulário | O que preencher |
|---|---|
| Client ID (obrigatório) | O Client ID fornecido pelo C6 para esta conta. |
| Client Secret (obrigatório) | O Client Secret fornecido pelo C6. É gravado criptografado. |
| Ambiente (obrigatório) | Sandbox ou Produção. O sandbox funciona de segunda a sexta, das 7h às 22h. |
| Arquivo .crt (obrigatório) | O certificado em formato PEM fornecido pelo C6. |
| Arquivo .key (obrigatório) | A chave privada em formato PEM fornecida pelo C6. |
| Senha do certificado | Apenas se a chave tiver senha. É gravada criptografada. |
| Carteira | Preenchida automaticamente conforme o ambiente escolhido. |
Problemas comuns
- O certificado é recusado no upload: o Hap valida se o .crt e o .key são do mesmo par antes de gravar. Se a mensagem apontar isso, os dois arquivos não combinam - peça o par correto ao C6.
- Testar credenciais falha só em sandbox: o ambiente de testes do C6 fica disponível de segunda a sexta, das 7h às 22h. Fora desse horário ele não responde.
- O extrato recusa o período pedido: o C6 devolve no máximo 30 dias por consulta. Divida o período.
- O lote de pagamentos ficou parado: o C6 exige aprovação manual dentro do internet banking. O Hap inicia o lote e espera a confirmação - o pagamento só sai depois que alguém aprovar lá.
- A conta pede Client ID e Secret mesmo já tendo certificado: são duas camadas diferentes. O certificado prova qual máquina está chamando; o Client ID e o Secret provam qual aplicação contratada está usando aquela máquina.