# Conectar a Efí (Pix na página)

Pix com QR Code gerado na hora e confirmado sozinho, direto na conta Efí de vocês.

Fonte: https://docs.altaris.love/artigo/efi/

Com a Efí conectada, o convidado vê um **QR Code de Pix no próprio site**, paga pelo app do banco e o presente é confirmado sozinho, em segundos, sem sair da página. O valor entra na **conta Efí de vocês**.

É a única forma de Pix que se confirma sem ninguém avisar: o [PIX estático](https://docs.altaris.love/artigo/pix-estatico/) depende de o convidado dizer "já paguei" e de vocês conferirem no extrato.

> Gateways de cartão fazem parte dos planos com essa opção — [confira o seu](https://docs.altaris.love/artigo/planos-e-cupons/). A Efí entra nessa mesma regra.

## Antes de começar

A Efí é a conexão mais trabalhosa das nossas, porque a API Pix dela exige um **certificado**. Vocês precisam de:

- uma conta [Efí](https://sejaefi.com.br) com a API liberada — modo **Pro** (para CPF) ou **Empresas** (para CNPJ);
- uma **chave Pix cadastrada** nessa conta — é nela que os presentes entram;
- um computador: o certificado é um arquivo, e o app não serve para isso.

## Criando a aplicação e o certificado

1. Entrem na Efí pelo computador e, em **API → Aplicações**, criem uma aplicação com a **API Pix**, em **produção**, marcando os escopos de cobrança: _consultar_ e _alterar_. O passo a passo oficial está em [dev.efipay.com.br](https://dev.efipay.com.br/docs/api-pix/credenciais);
2. Copiem o **Client_Id** e o **Client_Secret** de produção;
3. Em **API → Meus certificados**, criem um certificado para essa aplicação e baixem o arquivo **.p12**.

## Conectando no Altaris

1. **Painel → Pagamentos → Conectar**, no cartão da Efí;
2. Colem o Client_Id e o Client_Secret, enviem o arquivo .p12 e informem a chave Pix da conta;
3. Salvem. Nós testamos tudo na hora criando uma cobrança de R$ 0,01 que expira sozinha em um minuto — "conectado" = o Pix da Efí já aparece nos presentes.

As credenciais e o certificado ficam guardados **criptografados** e nunca aparecem de novo no painel.

## Como os pagamentos chegam

O convidado escolhe "Pix pela Efí", o QR Code aparece na página com o copia-e-cola, e ele paga pelo app do banco. A página confere o pagamento sozinha e troca o QR pela confirmação; o convidado recebe e-mail. Quem fechar a página antes não perde nada: conferimos as cobranças pendentes uma vez por dia e o presente é marcado como recebido do mesmo jeito.

Cada QR Code vale por **1 hora**. Expirado, basta clicar de novo no presente para gerar outro.

## Problemas comuns

- **"Chave Pix inválida" ao conectar**: a chave precisa estar cadastrada **nessa** conta Efí — chave de outro banco não serve.
- **Certificado recusado**: o .p12 tem que ser da mesma aplicação de onde saíram o Client_Id e o Client_Secret, e de **produção** (o de homologação não recebe dinheiro).
- **Não acho "API" no menu**: a conta ainda está no modo básico. A liberação da API é feita com a Efí (Pro ou Empresas).