Efí (Gerencianet)
Receba o Pix direto na sua conta Efí: criar a aplicação, gerar o certificado .p12, cadastrar a chave Pix e conectar na Kyo.
Nesta página
Com a Efí Bank (antiga Gerencianet), o Pix é gerado pela API Pix oficial na sua conta Efí e o dinheiro cai direto nela. Vale a taxa de Pix da sua conta. Guia oficial: dev.efipay.com.br.
O que você precisa
| Campo | Onde encontrar |
|---|---|
| Client ID | Na aplicação criada em API › Aplicações, no ambiente escolhido. |
| Client Secret | Na mesma aplicação, do mesmo ambiente do Client ID. |
| Chave Pix que recebe | Uma chave Pix cadastrada na sua conta Efí (e-mail, telefone, CPF/CNPJ ou aleatória). |
| Certificado (.p12) | Baixado em API › Meus Certificados, do mesmo ambiente das credenciais. |
| Senha do certificado | Só se o seu certificado tiver senha. Normalmente fica em branco. |
1. Criar a aplicação
Na sua conta Efí, abra API (menu no canto inferior esquerdo) e clique em Criar aplicação
Ative a API Pix e marque os escopos de cobrança
Marque
cob.writeecob.read, em produção e, se for testar, em homologação. Sem esses escopos o teste da Kyo avisa qual está faltando.Copie o Client ID e o Client Secret do ambiente que você vai usar
2. Gerar o certificado
Abra APIMeus Certificados
Escolha o mesmo ambiente das credenciais
Clique em Novo Certificado e baixe o arquivo .p12 na hora
O arquivo não fica disponível para baixar depois. Se perder, gere outro.
3. Chave Pix
Tenha uma chave Pix cadastrada na sua conta Efí e informe essa chave na Kyo. É nela que o dinheiro das vendas cai. A chave não é segredo: ela aparece para quem paga no próprio Pix.
4. Conectar na Kyo
Abra Pagamentos e escolha Efí Bank
Ou use
/pagamentosno Discord e escolha Efí Bank na lista.Preencha Client ID, Client Secret e a chave Pix
Envie o certificado .p12
No site, pelo campo de arquivo. No Discord, o formulário de Informar credenciais (produção) tem um campo de arquivo (até 64 KB). Se o seu Discord não mostrar esse campo, use o site.
Clique em Testar e salvar
A Kyo pede um token à Efí usando o certificado, sem criar cobrança. Deu certo: aparece "Produção conectada" e as próximas vendas já usam a Efí.
Testar antes de vender
Quer testar sem dinheiro de verdade? Marque Credenciais de homologação (teste, sem dinheiro de verdade) no site, ou use o botão Homologação no Discord, com o Client ID, Client Secret e certificado de homologação.
- Faça uma compra de teste na sua loja e confira o pedido em Vendas e pedidos.
- Quando estiver tudo certo, conecte de novo com as credenciais e o certificado de produção.
Confirmação dos pagamentos
Você não precisa configurar webhook na Efí. A Kyo confere cada Pix pendente direto na API da Efí (a cada minuto nos primeiros 30 minutos) e libera o pedido assim que o pagamento aparece.
Problemas comuns
| Mensagem | O que fazer |
|---|---|
| Certificado inválido ou senha do certificado errada | Baixe o .p12 de novo na Efí. Se o certificado tiver senha, informe a senha certa; se não tiver, deixe o campo vazio. |
| Client ID ou Client Secret recusados pela Efí | Copie de novo as credenciais, conferindo se são do mesmo ambiente (produção ou homologação) que você escolheu. |
| A Efí não aceitou o certificado | O certificado é de outro ambiente ou de outra conta. Gere um novo no mesmo ambiente das credenciais. |
| A aplicação não tem o escopo cob.write / cob.read | Em API › Aplicações › API Pix, marque os escopos de cobrança e salve. |
| O certificado enviado está vazio ou incompleto | Envie o arquivo .p12 original, sem renomear nem converter. |
| Pix gerado mas não confirma | Veja O Pix não confirma em Solução de problemas. |