Conectar Efí (Gerencianet)

⏱ Tempo estimado: 15–20 minutos

O Efí é mais complexo que os outros PSPs porque usa autenticação mTLS com certificado digital. Mas tem as menores taxas do mercado e uma comunidade dev muito ativa.

1. Acesse sejaefi.com.br
2. Clique em "Abrir conta"
3. Escolha entre conta PJ (Efí Empresas) ou PF (Efí Pro)
4. Preencha seus dados e siga o processo de verificação
5. Aguarde aprovação da conta

Você precisa de uma chave Pix cadastrada na sua conta Efí para criar cobranças.

1. Acesse sua conta Efí
2. No menu lateral, clique em Pix
3. Clique em Minhas Chaves → Cadastrar Chave
4. Escolha o tipo (CPF, CNPJ, email, telefone ou aleatória)
5. Confirme com sua Assinatura Eletrônica
6. Copie e guarde a chave — vai precisar dela no Hubpay

1. No menu lateral, clique em API
2. Clique em Aplicações → Nova aplicação
3. Dê um nome (ex: "Hubpay")
4. Ative a API Pix e marque os escopos:
   • cob.write (criar cobranças)
   • cob.read (consultar cobranças)
   • pix.read (consultar Pix recebidos)
   • webhook.write (configurar webhooks)
   • webhook.read (consultar webhooks)
5. Ative os escopos tanto para Produção quanto para Homologação
6. Clique em "Continuar"
7. Copie o Client ID e Client Secret do ambiente desejado

O Efí exige um certificado digital (.p12) para autenticação mTLS.

1. No menu lateral, clique em API
2. Clique em Meus Certificados
3. Selecione o ambiente: Homologação (sandbox) ou Produção
4. Clique em Criar Certificado
5. Confirme com sua Assinatura Eletrônica
6. Baixe o arquivo .p12 gerado

O Hubpay precisa do certificado no formato .pem. Converta com o comando:

openssl pkcs12 -in certificado.p12 -out certificado.pem -nodes

Quando pedir senha, digite a senha do certificado (no sandbox geralmente é vazia — aperte Enter). Para ver o conteúdo que você vai colar no Hubpay:

cat certificado.pem

1. Acesse hubpay.dev/dashboard/psps
2. Clique em Conectar novo PSP
3. Selecione Efí
4. Selecione o ambiente (Test = Homologação, Live = Produção)
5. Dê um label (ex: "Efí principal")
6. Preencha:
   • Client ID: cole o Client ID da aplicação
   • Client Secret: cole o Client Secret
   • Chave Pix: cole a chave Pix cadastrada no passo 2
   • Certificado PEM: cole o conteúdo completo do arquivo .pem
7. Clique em Salvar credencial

curl -X POST https://api.hubpay.dev/v1/charges \
  -H "Authorization: Bearer hpx_test_SUA_CHAVE_HUBPAY" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 1000,
    "provider": "efi",
    "description": "Teste Efí"
  }'

Após salvar a credencial, o Hubpay gera uma URL de webhook única pra ela. O Efí faz um GET de verificação na URL antes de ativá-la — o Hubpay já responde 200 nesse handshake. Formato:

https://api.hubpay.dev/api/wh/{uuid}

1. Em /dashboard/psps, no menu "..." da credencial, clique em Copiar URL do webhook e Copiar token do webhook.
2. No painel Efí: API → Minhas Aplicações → sua aplicação → Webhooks (Pix). Cole a URL adicionando o token como query param:
   textCopiar

   https://api.hubpay.dev/api/wh/{uuid}?token=SEU_TOKEN

   ou, se preferir, configure o header x-efi-webhook-token.
3. Vincule o webhook à chave Pix cadastrada no passo 2.
4. Salve. O Efí envia automaticamente notificações de Pix recebidos vinculados àquela chave.

Solução de problemas

Links úteis

• Painel Efí
• Documentação Efí
• Discord Efí (suporte dev)