O que é
A EFI (antiga Gerencianet) é um dos meios de pagamento do Voucher PIX. Com ela configurada, o visitante paga o plano com PIX no portal do WiFi, a EFI avisa o painel do pagamento e o acesso é liberado sozinho.
Você vai precisar de quatro itens da sua conta EFI: Client ID, Client Secret, o certificado da aplicação e uma chave PIX cadastrada na conta.
Onde fica
No painel: menu Configurações → Integrações → cartão EFI (Gerencianet) → Configurar.
Passo a passo
1. Na EFI: chave PIX
- Entre na sua conta EFI.
- No menu Pix, confira se há uma chave cadastrada (CPF, CNPJ, e-mail, telefone ou aleatória). Se não houver, cadastre uma.
2. Na EFI: criar a aplicação
- Vá em API → Aplicações e clique em Criar aplicação.
- Dê um nome (por exemplo, "WiFi") e ative a API Pix.
- Marque os escopos, em Produção e em Homologação: criar e consultar cobranças (
cob.writeecob.read), consultar o QR Code das cobranças (payloadlocation.read) e alterar e consultar webhooks (webhook.writeewebhook.read). - Salve. A EFI mostra o Client ID e o Client Secret de cada ambiente. Guarde os dois.
3. Na EFI: baixar o certificado
- Vá em API → Meus Certificados.
- Escolha o ambiente (Produção para vender de verdade) e gere um novo certificado para a aplicação.
- Baixe o arquivo (.p12) e guarde em lugar seguro.
4. No painel
- Abra Configurações → Integrações → EFI (Gerencianet) → Configurar.
- Client ID e Client Secret: cole os valores da aplicação, do mesmo ambiente do certificado.
- Certificado: clique em Selecionar arquivo e escolha o arquivo baixado da EFI. A tela mostra Certificado carregado.
- Chave PIX: digite a chave cadastrada na EFI, exatamente como aparece lá.
- Modo Sandbox: marque só se as credenciais e o certificado forem de Homologação. Para vender de verdade, deixe desmarcado.
- Em Status da Integração, deixe a integração ativa.
- Clique em Salvar Configuração.
Ao salvar com a integração ativa, o painel cadastra o webhook na EFI sozinho e mostra o resultado: "Webhook registrado com sucesso na EFI" ou um aviso com o motivo da falha. A URL do Webhook exibida na tela serve só para conferência.
5. Criar os planos
Com a EFI ativa, crie os planos de venda e ligue o Voucher PIX no hotspot: veja Como configurar planos para Voucher PIX.
Sandbox x produção
| Ambiente | Credenciais e certificado | Modo Sandbox |
|---|---|---|
| Homologação (testes) | Os de Homologação. Nenhum dinheiro de verdade circula. | Marcado |
| Produção (vendas reais) | Os de Produção. | Desmarcado |
Credencial de um ambiente com certificado do outro não funciona. Ao passar para produção, troque os três juntos (Client ID, Client Secret e certificado) e desmarque o Modo Sandbox.
Dicas e observações
- Deixe só um meio de pagamento ativo em Integrações.
- A EFI não tem o botão Testar Configuração. Para validar, salve, confira a mensagem do webhook e faça uma compra de teste de valor baixo.
- Não cadastre o webhook à mão na EFI: o registro automático já usa o endereço certo.
Problemas comuns
| Sintoma | O que fazer |
|---|---|
| Aviso de permissão insuficiente para o webhook | Na EFI, edite a aplicação, marque o escopo de alterar webhooks (webhook.write) no ambiente usado e salve a integração de novo. |
| Erro de autenticação | Client ID, Client Secret e certificado precisam ser da mesma aplicação e do mesmo ambiente. Confira também o Modo Sandbox. |
| Erro ao processar o certificado | Baixe um certificado novo em Meus Certificados e envie de novo. |
| O QR Code não é gerado no portal | Confira se a Chave PIX digitada está cadastrada na conta EFI. |
| Pagou e não liberou | Salve a integração de novo e veja se aparece "Webhook registrado com sucesso". Se aparecer outro aviso, corrija o que ele indica. |