Conectar a Efí (Gerencianet)

O que é a integração

Ao conectar a Efí (Gerencianet) na CopyFunnel, seu checkout passa a oferecer Pix (API Pix, com mTLS obrigatório), cartão de crédito e boleto (API de cobranças legada, sem mTLS). O número do cartão é tokenizado no navegador do comprador (script de payment token da Efí, alimentado pelo seu Identificador de Conta) — o dado cru nunca passa pelo servidor da CopyFunnel. Reembolso suportado nos dois mundos (devolução Pix integral + refund de cartão).

Onde pegar as credenciais

A Efí usa seis itens — os caminhos abaixo seguem os próprios placeholders do painel Efí:

1. Faça login no painel da Gerencianet/Efí com a conta que recebe o dinheiro.
2. No menu API, abra a área Aplicação (ou crie uma nova aplicação) e copie o Client_Id e o Client_Secret de produção.
3. Em API → Introdução → Identificador de Conta, copie o payee_code.
4. Cadastre (ou copie) a Chave Pix registrada na Efí — pode ser chave aleatória, e-mail, CPF/CNPJ ou telefone.
5. Na área da API Pix, emitir o certificado (.p12) e salve a senha definida na emissão.
6. Se quiser homologação antes do produção, a Efí usa os ambientes pix-h/cobrancas-h — nesse caso marque a opção de sandbox na CopyFunnel.

Conectar na CopyFunnel

1. No painel da CopyFunnel, entre em Integrações.
2. Clique no card da Efí (Gerencianet) (status do card: Não configurado, Configurado ou Conectado).
3. No drawer que abre, preencha:
   • Client ID (placeholder: "Client_Id (Efí → API → Aplicação)") — campo visível, obrigatório.
   • Client Secret (placeholder: "Client_Secret da aplicação") — campo de senha, cifrado na CopyFunnel.
   • Chave PIX (placeholder: "Chave registrada na Efí (aleatória, e-mail, CPF/CNPJ ou telefone)") — obrigatória para Pix.
   • Identificador de Conta (placeholder: "payee_code (Efí → API → Introdução → Identificador de Conta)") — não é segredo e o Pix funciona sem ele, mas sem payee_code o cartão não roteia (o botão de cartão não aparece).
   • Certificado mTLS (P12) (placeholder: "Arquivo .p12 emitido na Efí") — campo de arquivo; o P12 é lido no navegador e vai cifrado para a CopyFunnel. O arquivo salvo aparece como "salvo: {nome} — escolha um novo p/ substituir".
   • Senha do certificado — senha do arquivo P12 (vazio em um save posterior preserva a salva).
4. Marque Usar sandbox (credenciais de teste) só se estiver usando as credenciais de homologação da Efí.
5. Clique em Testar conexão. O teste é completo: faz o OAuth da Efí + uma leitura das cobranças Pix (GET /v2/cob, janela de 1 dia) por trás do mTLS — ou seja, valida credenciais, chave, certificado e senha de uma vez. Com tudo certo aparece "Conexão realizada com sucesso."
6. Clique em Salvar. Ao salvar, a conexão é testada de novo: com sucesso você vê "Credenciais salvas e conexão verificada." e o card passa a Conectado.

Só a credencial Conectado entra no checkout.

O que acontece depois

Com a conexão validada, o checkout exibe Pix, cartão e boleto:

• Pix: cobrança imediata com pixCopiaECola direto na resposta — QR Code gerado localmente pela CopyFunnel. Reusa a mesma cobrança em retries (txid determinístico).
• Cartão: confirmação síncrona — aprovado na hora (status: approved) ou recusa com o motivo.
• Boleto: nasce pendente e compensa em 1–3 dias úteis, com linha digitável na página do pedido.

E diferente dos outros gateways, aqui a CopyFunnel registra o webhook automaticamente no primeiro salvamento validado (POST /v2/webhook?chave=... com um token próprio na URL — a Efí não tem assinatura HMAC nativa). Para cartão/boleto, a própria cobrança já leva a URL de notificação com o token. Nenhuma notificação aprova a venda sozinha: a CopyFunnel reconfirma na fonte (Pix: GET /v2/cob via mTLS; cobrança: GET /v1/charge/{id}). Se o registro do webhook falhar, a mensagem avisa: "Registro do webhook falhou — a confirmação usa polling até você retestar a conexão."

Para finalizar, faça uma compra de teste de R$ 1,00 (Pix é o mais rápido de validar) e confira se ela aparece em Vendas no painel com o status correto.

Dicas de erro comuns

• "Informe a Chave PIX registrada na Efí." — o campo da chave Pix ficou vazio ao salvar.
• "Envie o certificado mTLS (P12) da Efí." / "Envie o certificado mTLS (P12) para testar." — sem o certificado a API Pix não abre nem para testar. Escolha o arquivo .p12 (ou .pem).
• "Falha na autenticação. Verifique as credenciais." no teste da Efí pode significar: Client_Id/Client_Secret errados, senha do P12 errada, certificado corrompido/expirado ou certificado que não pertence à conta. O teste falha em qualquer uma dessas camadas — confira uma por uma.
• Certificado substituído sem necessidade — só envie um novo P12 quando for trocar o certificado; o nome do salvo aparece ao lado do campo.
• Cartão não aparece no checkout com credencial Conectado — falta o payee_code: o script de tokenização do navegador depende dele. Salve o Identificador de Conta e teste de novo.
• "EFI: chave PIX não configurada na credencial." — a credencial salva está sem chave Pix; reconecte com a chave.
• Reembolso repetido de Pix — a segunda devolução do mesmo valor é tratada como idempotente ("devolução já registrada"), não é erro.