Pagamentos

Efí Bank

Receba Pix na sua conta Efí com uma aplicação e um certificado.

A Efí processa Pix na Promisse Store. A conexão pede uma aplicação da API, um certificado .p12 e a sua chave Pix.

Na sua conta Efí#

  1. Abra a área de API#

    Entre na sua conta e abra o menu API. Se ele não aparecer, ative o Efí Pro na conta.

  2. Crie uma aplicação#

    Em Aplicações, crie uma nova aplicação e dê um nome a ela, como Promisse Store.

    Ative os escopos da API Pix. A integração precisa destes quatro:

    Escopo Para que serve
    cob.write Criar cobranças
    cob.read Consultar cobranças
    pix.write Devolver um Pix
    webhook.write Cadastrar o webhook da chave Pix
  3. Copie as credenciais de produção#

    A aplicação tem credenciais de produção e de homologação. Copie o Client ID e o Client Secret de produção.

  4. Gere o certificado#

    Em Meus Certificados, crie um certificado de produção e baixe o arquivo .p12.

  5. Escolha a chave Pix#

    Use uma chave Pix da mesma conta. Ela é informada no painel da loja.

No painel da loja#

Abra Pagamentos, clique em Conectar na Efí Bank e preencha:

Campo O que colar Obrigatório
Client ID Client ID de produção Sim
Client Secret Client Secret de produção Sim
Certificado (.p12) O arquivo baixado Sim
Senha do certificado Deixe vazio se o certificado não tiver senha Não
Chave Pix Chave da própria conta Efí Sim

Ao salvar, a plataforma cadastra o webhook na sua chave Pix.

Bom saber#

  • O reembolso pelo painel inicia a devolução, e a Efí conclui depois.
  • A confirmação do pagamento é feita por webhook e por consulta periódica à Efí.

Problemas comuns#

  • Certificado .p12 inválido ou senha incorreta. Confira se o arquivo é o .p12 de produção e se a senha está certa. Sem senha, deixe o campo vazio.
  • A Efí recusa a conexão. Veja se a aplicação tem os quatro escopos e se as credenciais são de produção, não de homologação.