Configure o EFI Bank (antiga Gerencianet) como gateway de pagamento Pix no portal captive do CaptiveWeb. O EFI usa autenticação por certificado (mTLS), por isso o cadastro pede um arquivo de certificado além das credenciais.

ℹ️
Pré-requisitoConta no EFI Bank com a API Pix habilitada, uma chave Pix cadastrada na conta e uma aplicação criada no painel do EFI (para obter Client ID e Client Secret).

1. Obter as credenciais no painel EFI

  1. Crie uma aplicação Pix

    No painel do EFI, vá em API → Aplicações e crie (ou abra) uma aplicação com o escopo de Pix habilitado. Selecione o ambiente desejado: Produção ou Homologação.

  2. Copie o Client ID e o Client Secret

    Na aplicação, copie o Client ID e o Client Secret. Use os valores do mesmo ambiente que você vai configurar no CaptiveWeb (produção ou sandbox).

  3. Gere o certificado mTLS

    Em Minha Conta → Certificados, gere e baixe o certificado da aplicação. O EFI entrega um arquivo .p12 ou .pem — o CaptiveWeb aceita os dois e converte automaticamente.

  4. Confirme a chave Pix

    Anote a chave Pix cadastrada na conta EFI (CPF/CNPJ, e-mail, telefone ou chave aleatória). É nela que os recebimentos serão creditados.

⚠️
Produção x HomologaçãoO Client ID, o Client Secret e o certificado são diferentes em cada ambiente. Não misture credenciais de produção com o certificado de homologação — a autenticação falha.

2. Cadastrar a integração no CaptiveWeb

  1. Acesse Configurações → Integrações

    No painel, clique em Configurações no menu e depois em Integrações.

  2. Nova integração EFI Bank

    Clique em Nova integração e selecione EFI Bank (Gerencianet) — tipo efi.

  3. Preencha as credenciais

    Informe o Client ID e o Client Secret da aplicação, e a Chave Pix cadastrada no EFI Bank.

  4. Envie o certificado mTLS

    No campo Certificado mTLS, selecione o arquivo .p12 ou .pem baixado do EFI. O sistema armazena o certificado de forma segura (não é necessário reenviá-lo a cada edição — aparece "Certificado salvo").

  5. Defina a validade da cobrança

    Em Validade da cobrança (segundos), mantenha 3600 (1 hora) ou ajuste o tempo que o QR Code Pix fica válido para pagamento.

  6. Marque o ambiente correto

    Deixe Ambiente de homologação (sandbox) marcado apenas para testes. Desmarque para produção. Clique em Salvar.

  7. Verifique o gateway em Pagamentos

    Em Configurações → Pagamentos, o EFI Bank aparecerá na lista de gateways disponíveis. Se usar mais de um gateway, defina a prioridade.

ℹ️
Teste rápidoNa própria tela da integração EFI há o botão Testar Pix, que gera uma cobrança de validação e confirma se as credenciais e o certificado estão corretos antes de publicar no portal.

3. Webhook de confirmação

O CaptiveWeb registra automaticamente o webhook do EFI na primeira cobrança — o endpoint é https://administrativo.captiveweb.com.br/webhooks/efi. Não é necessário configurar nada manualmente no painel do EFI. É por esse webhook que o pagamento é confirmado e o acesso liberado.

4. Walled Garden para Pix

Adicione os domínios do EFI no Walled Garden do equipamento de rede, para que o QR Code Pix carregue antes da autenticação:

pix.api.efipay.com.br
pix-h.api.efipay.com.br

5. Fluxo do usuário

  1. Usuário seleciona o plano

    No portal captive, escolhe o plano de acesso pago.

  2. Geração do QR Code Pix

    O CaptiveWeb cria a cobrança via EFI e exibe o QR Code (e o copia-e-cola).

  3. Pagamento

    O usuário paga com o app do banco. A tela faz polling do status até confirmar.

  4. Confirmação automática

    O EFI notifica o CaptiveWeb via webhook, o pagamento é confirmado e o acesso é liberado automaticamente via RADIUS CoA.

⚠️
Certificado com aviso de validadeSe o EFI exibir aviso ao gerar o certificado, gere-o novamente no painel e reenvie no CaptiveWeb. Um certificado expirado ou inválido impede a autenticação e nenhuma cobrança é criada.