C6 Bank: conectar a integração, credenciais e certificado digital
O QUE ESTA FONTE RESOLVE
Aqui está o que você precisa ter em mãos para conectar a conta do C6 Bank ao sistema, o que cada campo da tela significa e por que a conexão falha ou para de funcionar depois de um tempo. A integração com o C6 é bancária, por API: boleto, Pix, extrato e saldo. Ela é recente e ainda está em fase de validação, então não existe data prometida de liberação.
O roteiro comum de integrar um meio de pagamento e o funcionamento geral do Pix estão na pasta Meios de pagamento (52). O vínculo da integração por loja, a opção Gerar venda e o efeito de remover uma integração estão na fonte 222, na raiz de Integrações. Esta fonte não repete nada disso.
O QUE VOCÊ PRECISA TER EM MÃOS ANTES DE COMEÇAR
A tela de conexão pede sete informações, e essa lista é fechada: agência e dígito verificador; conta corrente e dígito verificador; chave Pix aleatória (EVP); Client ID; Client Secret; o certificado digital; e a chave privada (.key). Quando o certificado é um .pfx (ou .p12) aparece um oitavo campo, a senha do certificado, e a chave privada deixa de ser exigida.
Tudo isso é gerado no portal do C6 Bank, com a conta da sua empresa. O sistema não gera, não emite e não recupera nenhuma dessas informações. Se você não tem alguma delas, o caminho é o portal do C6.
CNPJ E NOME FANTASIA NÃO SÃO DIGITADOS
O sistema pega o CNPJ e o nome fantasia dos dados da empresa (loja) em que você está logado e monta o nome da integração juntando os dois, no formato "nome fantasia - CNPJ". Por isso a tela não pergunta seu CNPJ. Se o dado estiver errado ali, corrija no cadastro da empresa e não na integração.
CAMPO A CAMPO
Agência/DV: o número da agência tem de 1 a 4 números, e o dígito verificador vai no campo pequeno ao lado, depois do traço. Não digite o dígito junto do número.
Conta/DV: o número da conta corrente tem de 1 a 8 números, e o dígito também vai no campo separado.
Chave PIX: precisa ser a chave aleatória (EVP) cadastrada no C6 Bank. É ela que o sistema usa para gerar o QR Code das cobranças e para registrar o webhook que avisa o sistema quando um Pix cai. Chave de e-mail, telefone ou CPF/CNPJ não servem aqui.
Client ID e Client Secret: são as credenciais do aplicativo criado no portal do C6 Bank. O Client Secret é digitado mascarado.
Certificado e chave privada: o campo se chama "Certificado (.crt ou .pfx)" e a mensagem de obrigatoriedade do sistema cita .crt, .pem ou .pfx; um .p12 é tratado como .pfx. Você tem dois caminhos: enviar o par de arquivos (certificado mais a chave .key) exatamente como saiu do portal do C6, ou, se você converteu para .pfx, enviar só o .pfx e informar a senha definida na conversão.
O sistema não julga o arquivo pela extensão: a tela só confere se você anexou algo. Quem examina o conteúdo do certificado é o servidor — por isso a mensagem de erro de certificado inválido vem de lá, e ela vale mais do que o nome do arquivo.
OS ARQUIVOS SÃO DE ESCRITA APENAS
Depois de enviados, certificado e chave nunca voltam para a tela. O sistema guarda e devolve só um indicador de que existe algo salvo: os campos aparecem vazios, com o aviso "Certificado já configurado" e "Chave já configurada". Isso é proposital — o conteúdo de um certificado e de uma chave privada não deve trafegar de volta para o navegador.
A consequência prática: quando você reabre o formulário de credenciais de uma integração que já existe, os arquivos passam a ser opcionais. Deixe-os em branco para manter o certificado atual; só anexe arquivo de novo quando quiser realmente substituí-lo. A própria tela avisa isso.
CONECTAR
Com tudo preenchido, o botão é Conectar com C6 Bank. Se der certo, o sistema mostra a mensagem de sucesso e leva você para a tela da integração. Se ainda não houver nenhuma integração selecionada, essa passa a ser a selecionada.
OS ESTADOS DA INTEGRAÇÃO
Pendente (não conectada): a tela mostra o formulário de credenciais e o botão Conectar com C6 Bank. É o estado de quem ainda não conectou e também de quem desconectou. Nada opera no banco.
Conectada (o sistema trata "conectada" e "ativa" da mesma forma): a tela troca. Aparece o cartão Informações da integração, com o token de acesso, a conta, a agência e a data da última atualização, e ao lado o botão Desconectar. Na mesma tela ficam o cartão Credenciais e a parte de configuração: Forma de pagamento (uma forma para recebimento de boleto e uma para recebimento de Pix), Multa/Juros e Notificações, onde você informa o e-mail — obrigatório — que recebe alerta caso a confirmação automática de um pagamento recebido falhe. O botão Salvar configurações grava; o Cancelar descarta o que foi digitado e volta para a listagem.
Para saber em que estado está, abra a integração: se aparecer o cartão Informações da integração com o botão Desconectar, ela está conectada; se aparecer o formulário de credenciais, não está.
Vale lembrar o que a fonte 222 e a pasta 52 já explicam: a integração só começa a operar de fato depois que existir uma forma de pagamento apontando para ela. Na busca de formas de pagamento só aparecem as que ainda não têm integração e as que já estão ligadas ao C6 — se a forma que você quer não aparece, é porque ela já está vinculada a outra integração.
O AVISO DE VENCIMENTO DO CERTIFICADO
O sistema consulta o certificado guardado e avisa quando falta 30 dias ou menos para o vencimento, dizendo quantos dias faltam; se já estiver vencido, o aviso muda e diz que venceu.
Atenção a onde esse aviso aparece: ele fica na tela de credenciais de uma integração que já existe mas não está conectada — tipicamente logo depois de desconectar. Na integração conectada essa tela não é exibida, então não conte com o aviso aparecendo sozinho todo dia. É um aviso, não uma trava: ele não impede nada.
O próprio texto do aviso traz o ponto que mais gera chamado: ao renovar o certificado, o C6 gera também um novo Client ID e um novo Client Secret. O certificado novo sozinho não resolve — as três coisas precisam ser atualizadas aqui juntas, e a forma de fazer isso está na seção de defeito, mais abaixo.
DESCONECTAR
O botão Desconectar fica no cartão Informações da integração. Depois dele a integração volta para o estado pendente e o formulário de credenciais reaparece na mesma hora. Se aquela era a integração selecionada, a seleção é removida.
O cadastro da integração não é apagado: você continua abrindo a mesma integração, agora pela tela de credenciais. Para voltar a operar, reconecte. Como os arquivos são opcionais nessa tela, o certificado que já estava salvo é mantido se você deixar os campos em branco — envie arquivo apenas se quiser trocá-lo.
O QUE COSTUMA DAR ERRADO
Credenciais de um aplicativo e certificado de outro. É a causa mais comum de "integrei e não funciona". O Client ID/Secret e o certificado pertencem ao mesmo aplicativo; misturar os de aplicativos diferentes derruba a autenticação, e a mensagem que volta é genérica.
Certificado vencido. Enquanto ele vale, tudo funciona; no dia do vencimento a integração "para do nada", sem que ninguém tenha mexido em nada.
Renovou o certificado e parou. Renovar gera Client ID e Client Secret novos. Enviar só o certificado novo deixa a integração com credenciais velhas.
Dígito digitado junto do número. Agência 1234-5 digitada inteira no campo do número, ou conta com o dígito colado, faz o banco não reconhecer a conta. O número vai num campo e o dígito no outro.
Chave Pix que não é aleatória. Só a chave EVP serve para o QR Code e para o webhook de recebimento.
TROCAR CREDENCIAL PELA TELA DA INTEGRAÇÃO CONECTADA NÃO FUNCIONA
Este é um defeito confirmado no sistema, não um erro seu. Na integração conectada, o cartão Credenciais mostra agência/DV, conta/DV, Chave PIX, Client ID e Client Secret em campos editáveis — mas esse cartão não tem botão de salvar próprio, e o botão Salvar configurações, que grava o restante da tela, remove de propósito o Client ID, o Client Secret e a senha do certificado do que é enviado, porque esses dados pertencem ao momento da conexão. Agência e conta digitadas ali também não persistem.
A Chave PIX é a exceção: ela é salva pelo botão Salvar configurações. Cuidado, porém, que existem dois campos de Chave Pix na tela — o do cartão Credenciais e o que aparece no cartão Forma de pagamento depois de escolher a forma de recebimento Pix. Quem vale no salvamento é o do cartão Credenciais; alterar apenas o outro não tem efeito.
Enquanto o defeito não é corrigido, o caminho para trocar qualquer credencial é: Desconectar e conectar de novo, informando as credenciais novas. É também o que você deve fazer depois de renovar o certificado no C6 — nesse caso, envie junto o certificado e a chave novos.
ORDEM PARA INVESTIGAR UMA CONEXÃO QUE NÃO ENTRA
Primeiro, confirme que o certificado e a chave são o par gerado no portal do C6 e que ainda estão válidos. Depois, que o Client ID e o Client Secret são do mesmo aplicativo daquele certificado. Depois, que agência e conta foram digitadas sem o dígito no campo do número. Por último, que a chave Pix aleatória (EVP) existe mesmo na conta do C6. Só quando esses quatro pontos estiverem confirmados vale abrir chamado técnico.
SEGURANÇA NO ATENDIMENTO
Nunca envie Client Secret, senha do certificado ou o arquivo de chave privada por chat, e-mail ou chamado. Ninguém do suporte precisa dessas informações para ajudar você. Se elas já foram enviadas para alguém, gere credenciais novas no portal do C6 e reconecte a integração.
O QUE É DO ERP E NÃO DA INTEGRAÇÃO
Forma de pagamento, conta bancária, lançamento financeiro, cliente e produto continuam sendo do ERP: as telas de forma de pagamento acessadas a partir do C6 são as mesmas do módulo Financeiro do sistema, não telas próprias do C6. Dúvida sobre como cadastrar ou vincular uma forma de pagamento se responde pelas fontes do ERP e pela pasta Meios de pagamento (52).