Kyo Applications

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

CampoOnde encontrar
Client IDNa aplicação criada em API › Aplicações, no ambiente escolhido.
Client SecretNa mesma aplicação, do mesmo ambiente do Client ID.
Chave Pix que recebeUma 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 certificadoSó se o seu certificado tiver senha. Normalmente fica em branco.

1. Criar a aplicação

  1. Na sua conta Efí, abra API (menu no canto inferior esquerdo) e clique em Criar aplicação

  2. Ative a API Pix e marque os escopos de cobrança

    Marque cob.write e cob.read, em produção e, se for testar, em homologação. Sem esses escopos o teste da Kyo avisa qual está faltando.

  3. Copie o Client ID e o Client Secret do ambiente que você vai usar

2. Gerar o certificado

  1. Abra APIMeus Certificados

  2. Escolha o mesmo ambiente das credenciais

  3. 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

  1. Abra Pagamentos e escolha Efí Bank

    Ou use /pagamentos no Discord e escolha Efí Bank na lista.

  2. Preencha Client ID, Client Secret e a chave Pix

  3. 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.

  4. 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

MensagemO que fazer
Certificado inválido ou senha do certificado erradaBaixe 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 certificadoO 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.readEm API › Aplicações › API Pix, marque os escopos de cobrança e salve.
O certificado enviado está vazio ou incompletoEnvie o arquivo .p12 original, sem renomear nem converter.
Pix gerado mas não confirmaVeja O Pix não confirma em Solução de problemas.