Conectar a Efí (Pix na página)

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 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. 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í 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;
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).