API PIX da Efí (antiga Gerencianet): credenciais e certificado passo a passo

Publicado em 25 de agosto de 2026

A Efí (ex-Gerencianet) é uma das integrações PIX mais usadas do Brasil — documentação madura e ativação self-service. Este guia percorre a geração de credenciais, com destaque para a pegadinha clássica: o certificado só pode ser baixado uma vez.

O que você vai precisar antes

  • Conta digital Efí (PF ou PJ) verificada;
  • Chave PIX cadastrada na conta Efí.

Passo a passo

  1. Logue na conta e vá ao menu API → "Criar aplicação";
  2. Habilite a API Pix e selecione os escopos — produção e homologação são configurados separadamente;
  3. Copie o Client_Id e o Client_Secret (um par por ambiente);
  4. Vá em API → "Meus Certificados" e gere o certificado .p12 do ambiente desejado. Atenção: o download é imediato e único — guarde o arquivo em local seguro (máximo de 5 certificados por ambiente);
  5. Se o seu sistema pedir .pem/.key, converta o .p12 com o conversor oficial da Efí ou OpenSSL.

Documentação oficial: dev.efipay.com.br/docs/api-pix/credenciais.

O que guardar para plugar num sistema

  • Client_Id + Client_Secret de produção;
  • Certificado .p12 (ou o par .pem/.key convertido);
  • Chave PIX da conta Efí.

Cuidado com o custo total na plataforma errada

A tarifa da Efí é da instituição — mas em algumas plataformas de venda o organizador paga, além do ~1% da Efí, mais 3% da própria plataforma, taxa de lançamento e mensalidade. No Sistema Fortune não existe ágio sobre a tarifa do banco: só 0,99% pós-pago sobre o que você vendeu. A conta completa está no post Pós-pago vs. taxa antecipada.

Custos

Tabela pública na data desta publicação: 1,19% por PIX recebido via API (mín. R$ 0,01), negociável para alto volume — confirme em sejaefi.com.br/tarifas.

Veja também: Sicoob (tarifa zero em muitas cooperativas) · Banco Inter · Asaas.

O Sistema Fortune é apenas o meio tecnológico.

Nós fornecemos o software — o site, o PIX automático, o WhatsApp e os relatórios. Não realizamos sorteios, não intermediamos pagamentos e não movimentamos dinheiro: cada pagamento vai direto do comprador para a conta bancária do organizador, pela integração que ele configura com o banco dele. A legalização de cada campanha é responsabilidade do organizador. Quer fazer do jeito certo? Comece pelo nosso guia Como legalizar uma rifa .