Efí
Conecte a sua conta Efí para receber Pix, boleto e cartão, com o webhook do Pix registrado automaticamente.
A Efí recebe Pix pela API Pix e boleto e cartão pela API de Emissão de Cobranças. A MinePag usa as duas com as credenciais da sua aplicação na Efí, e o dinheiro cai direto na sua conta Efí.
O que você vai precisar
| Campo no painel | Onde encontrar | Obrigatório |
|---|---|---|
| Client ID | Na aplicação, em API › Aplicações | Sim |
| Client Secret | Na mesma aplicação | Sim |
| Certificado (.p12) | API › Meus certificados | Sim |
| Senha do certificado | Só se você criou o certificado com senha. Normalmente fica em branco. | Não |
| Chave Pix | A chave da conta Efí que vai receber as vendas: CPF, CNPJ, e-mail, telefone ou chave aleatória | Sim |
| Identificador de conta | API › Introdução. Só é usado para cartão. | Não |
Use tudo do mesmo ambiente
A Efí tem credenciais e certificados separados para Produção e Homologação. Para uma conexão em Produção, use o Client ID, o Client Secret e o certificado de Produção. Para Sandbox, use os de Homologação. Misturar os dois faz a Efí recusar a conexão.
Passo a passo
Crie a aplicação na Efí
Na sua conta Efí, abra API › Aplicações e crie uma aplicação (ou use uma que já exista).
Ative as APIs e os escopos
Na aplicação, ative a API Pix com estes escopos:
cob.writeecob.readpix.readepix.writewebhook.writeewebhook.read
Para vender com boleto e cartão, ative também a API de Emissão de Cobranças. Sem ela, a conexão funciona só com Pix.
Copie o Client ID e o Client Secret
Copie os dois valores do ambiente que você vai conectar (Produção ou Homologação).
Gere o certificado
Em API › Meus certificados, gere o certificado do mesmo ambiente e baixe o arquivo .p12. O arquivo precisa ter até 140 KB.
A Efí só deixa baixar o certificado uma vez. Guarde uma cópia em local seguro: se perder, será preciso gerar outro e atualizar as credenciais na MinePag.
Conecte na MinePag
- No painel da loja, abra Configurações › Gateways e clique em Conectar no cartão da Efí.
- Em Em qual ambiente?, escolha Produção ou Sandbox. Se quiser, dê um nome à conexão em Nome da conexão (opcional). O padrão é "Efí · Produção" ou "Efí · Sandbox".
- Clique em Continuar e preencha as credenciais. Em Certificado (.p12), clique em Escolher arquivo .p12.
- Marque Entendo que o webhook desta chave Pix será substituído pelo da MinePag. e clique em Continuar.
- Em Importar vendas antigas, escolha o período e clique em Conectar Efí.
Ao final, o painel mostra Efí conectado com o resultado do webhook, as formas de pagamento que passaram a usar a conexão e o início da importação.
Um webhook por chave Pix
A Efí aceita só um endereço de webhook por chave Pix. Ao conectar, o endereço da MinePag substitui o que estiver configurado nessa chave. Se outro sistema seu recebe avisos dessa chave, use outra chave Pix na MinePag. Ao desconectar, a MinePag remove o webhook da chave (depois de confirmar os Pix e boletos que ainda estavam em aberto), a não ser que outra conexão já use a mesma chave.
Formas de pagamento
A MinePag descobre o que a sua aplicação permite ao validar as credenciais:
| Configuração da aplicação | Formas disponíveis |
|---|---|
| Só a API Pix | Pix |
| API Pix + API de Emissão de Cobranças | Pix e boleto |
| As duas APIs + identificador de conta preenchido | Pix, boleto e cartão |
No checkout, os dados do cartão são protegidos no navegador do cliente pela biblioteca da Efí, com o identificador de conta. A MinePag recebe só um token de pagamento, nunca o número do cartão ou o código de segurança.
Se você ativar a API de Cobranças depois de conectar, abra a página da conexão e clique em Testar conexão: a MinePag confere de novo e libera boleto e cartão. Depois, escolha a Efí para essas formas em Rotas de pagamento.
Avisos de pagamento
- Pix: a MinePag registra o webhook na sua chave Pix ao conectar. O endereço leva um código de verificação próprio da conexão e, em Produção, só são aceitos avisos vindos dos servidores da Efí.
- Boleto e cartão: o endereço de aviso vai junto com cada cobrança. Não há nada para configurar.
Em qualquer caso, a MinePag consulta a cobrança na API da Efí antes de confirmar o pedido. Veja Webhooks dos gateways.
Reembolsos
| Forma | Reembolso pela MinePag |
|---|---|
| Pix | Total ou parcial, por devolução Pix. |
| Cartão | Parcial em até 90 dias; total em até 360 dias. |
| Boleto | Não é possível pela API. Devolva o valor por Pix pela sua conta Efí. |
Detalhes em Reembolsos e contestações.
Importação de histórico
A MinePag busca os Pix recebidos na sua conta e, se a API de Cobranças estiver ativa, também as cobranças de cartão e boleto. Veja Importação de histórico.
Trocar credenciais ou a chave Pix
Na página da conexão, preencha só os campos que mudaram em Credenciais e clique em Atualizar credenciais. Campos em branco mantêm o valor atual. Se você trocar a chave Pix, a MinePag registra o webhook na chave nova.
Mensagens de erro
| Mensagem | Como resolver |
|---|---|
| A Efí recusou o Client ID, o Client Secret ou o certificado. Confira se todos são do mesmo ambiente. | Confira se as credenciais e o certificado são do ambiente escolhido (Produção ou Homologação). |
| Não foi possível falar com a Efí. Confira se o certificado .p12 e a senha estão corretos. | Escolha de novo o arquivo .p12 certo. Se ele não tem senha, deixe Senha do certificado em branco. |
| Ative na aplicação da Efí os escopos: … | Ative os escopos listados na aplicação e tente de novo. |
| A chave Pix não pertence a esta conta Efí ou não está ativa. | Use uma chave Pix ativa da mesma conta das credenciais. |
| Informe o identificador de conta da Efí para aceitar cartão. | Preencha Identificador de conta em Atualizar credenciais. |
Mais casos em Problemas comuns.