Bom dia @gabreudev ! Para configurar o webhook Pix você deve enviar uma requisição PUT para a rota /v2/webhook/:chave, informando no body da requisição o webhookUrl.

Em homologação a Efí simula parcialmente o pagamento, mudando o status da cobrança para CONCLUIDA e acionando o webhook. Mas só em produção que aparece o objeto Pix que quitou a cobrança.

Bom dia, @cavalcanti_pa! Tudo bem?
O ideal é usar o webhook para receber notificações instantâneas sobre os pagamentos. Veja mais detalhes em nossa documentação técnica.

Bom dia pessoal, estou tentando implementar o webhook para api pix, estou implementando em c#. Poderiam indicar sites de hospedagem gratuitos para expor uma rota para o webhook?

Boa tarde, @andersonhsilva!
Para ter o retorno sobre os pagamentos pix é preciso configurar um webhook, os detalhes são descritos nessa página da nossa documentação: https://dev.efipay.com.br/docs/api-pix/webhooks/

Você deve utilizar o endpoint PUT /v2/webhook/:chave para registrar a webhook URL associada a sua chave Pix usada nas cobrança, assim saberemos qual URL notificar.

Pontuando que, você precisa ter uma URL pública para receber as notificações do Pix. E no servidor web da sua aplicação, é necessário configurar o mTLS para que a comunicação siga o padrão de segurança. Você encontra mais detalhes em nossa documentação técnica e nos vídeos a seguir:
https://youtu.be/hdyUHzNwVLY?list=PLRqvcUTH2VsWufBmzOdTVeLEOTGrPNoiu
https://youtu.be/XB9bcZFTV3M?list=PLRqvcUTH2VsWufBmzOdTVeLEOTGrPNoiu

Bom dia, @mikw0274! Como vai?
Para receber notificações de pagamentos via Pix, você precisa criar uma API back-end disponível em um domínio público com certificado SSL. Configure as rotas /webhook e /webhook/pix, por exemplo. Nestas rotas, você deve configurar a exigência da chave pública (mTLS) que estamos disponibilizando para garantir a autenticação mútua.

Depois de configurar essas rotas, basta consumir o endpoint PUT /v2/webhook/:chave para associar a chave Pix à URL desejada.

Se tiver mais alguma dúvida, conte com a gente!

Boa tarde @lucasfortaleza tudo certo?
Para vincular você precisa consumir o endpoint abaixo, informando a Chave e a URL a ser vinculadas
https://dev.efipay.com.br/docs/api-pix/webhooks#configurar-o-webhook-pix

Boa tarde! Gostaria de ajuda para vincular um webhook a uma chave Pix. Já tenho o webhook, a chave, as aplicações e credenciais. Só não descobri ainda como vincular o webhook à chave Pix para poder receber notificações de pagamento.

Estou com problema na criação dos webhooks de pix em produção, com o crt de homologação consegui criar normalmente a webhook para a chave pix, porém quando fui criar em produção me retorna o erro

to meio perdido rsrs, então no caso, li que da pra desligar o mTSL, com ele desligado, devo criar a rota e incluir ela através do método /v2/webhook/:chave, onde a chave á chave pix que esta sendo usada para a geração da cobrança e depois testar a resposta da api, é isso ? Desculpe o mar de perguntas, esse tipo de API Pix é nova pra mim.

Boa noite, estou com certa dificuldade para utilizar o webhook do pix e gostária de saber se algum pode me ajudar, estou registrando um webhook com sucesso porem após realizar o pagamento pela leitura do QR code não recebo nenhuma notificação

Não é possivel realizar a leitura de um qrcode emitido em homologação.
Somente as cobranças em produção são reconhecidas.
Porém você consegue testar o webhook de confirmação em homologação:

Na nossa documentação temos exemplos das informaçoes enviadas via webhook Pix. Veja: https://dev.efipay.com.br/docs/api-pix/webhooks#requisi%C3%A7%C3%A3o

Existe alguma documentação das possíveis variáveis que podem vir no post do webhook do Pix?

O que você deveria encontrar lá:
Um acesso em meu-dominio/webhook com a CA da Efí, dando 2xx;
Um acesso em meu-dominio/webhook sem a CA da Efí, dando 4xx;
Um acesso em meu-dominio/webhook/pix de quando o pagamento foi confirmado

Tenho esse endpoint tambem configurado(webhook/pix). O meu sistema roda em um vps com litespeed, nao encontrei enhum exemplo para litespeed. Outra coisa que nao ta batendo é que consigo acessar o endpoind (tanto o /webhook quando o /webhook/pix) pelo postman, pelo que entendi era pra dar erro 403, porem tb nao deveria poder registrar o webhook neste caso.

Se você configurar meu-dominio/webhook, a Efí vai te mandar o aviso em meu-dominio/webhook/pix .

Boa tarde, consegui registrar o webhook com uma chave aleatória (consigo listar pelo comonando pixListWebhook) porem qdo faço o pagamento usando esta chave(tamabem consigo listar os pix's enviados) não to recebendo o aviso no endpoint do webhook(nada chega). Ha alguma forma de ver o log das tentativas/erros de envio de aviso de pix feitos pela api da efi? Qualquer ajuda ou dica será bem vinda.

Bom dia! Estou obtendo o seguinte erro ao tentar criar um webhook: