Sincronizar o webhook do Pix Efí

O webhook é o endereço para onde a Efí avisa o Velo que um Pix foi pago. É ele que faz o QR Code do caixa confirmar o pagamento sozinho. O Velo registra o webhook ao salvar o Pix; se algo falhar, você registra de novo com um clique.

Antes de começar

• O Pix Efí precisa estar configurado, com a chave Pix e o certificado enviados. Veja Receber com Pix por QR Code no caixa e na loja virtual.

Passo a passo

1. Acesse Configurações > Integrações > EFI.
2. No painel Configurações do PIX, confira o status:
   • Configurada: o webhook está registrado. A linha Webhook mostra “Registrado em” com a data e a hora.
   • Webhook pendente: o Pix foi salvo, mas o aviso de pagamentos não foi registrado. [captura: Painel Configurações do PIX com o status do webhook, o ambiente e o botão Sincronizar webhook]
3. Clique em Sincronizar webhook.

O que acontece depois

• Aparece “Webhook Efí PIX registrado” e o status passa para Configurada.
• Os próximos Pix pagos no QR Code do caixa passam a confirmar sozinhos.
• Pode clicar em Sincronizar webhook quantas vezes precisar: registrar de novo não causa problema.

Dúvidas comuns

Apareceu “Não foi possível registrar o webhook agora — tente novamente”. A Efí não respondeu. Aguarde alguns minutos e clique de novo. Se continuar, confira se o certificado .p12 é o da seção Pix e se o Ambiente está em Produção.

O botão Sincronizar webhook não aparece. O painel só mostra o botão depois que o Pix é salvo pela primeira vez. Preencha a chave Pix, o documento do titular e o certificado e salve.

Veja também

• Receber com Pix por QR Code no caixa e na loja virtual
• Emitir boletos e receber Pix com a Efí