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í#
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.
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.writeCriar cobranças cob.readConsultar cobranças pix.writeDevolver um Pix webhook.writeCadastrar o webhook da chave Pix 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.
Gere o certificado#
Em Meus Certificados, crie um certificado de produção e baixe o arquivo
.p12.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
.p12de 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.

