Histórico de mensagens sobre webhook porta em pix

A ideia é esta mesmo, @alissonmaciel_32335. Você irá utilizar este endpoint PUT/v2/webhook/:chave para associar sua URL de notificação a sua chave Pix. E então as cobranças Pix que tiverem um txid e sua chave Pix, nós iremos enviar a notificação para a URL registrada. Essa configuração pode ser feita uma única vez.

Pontuando que para registrar sua URL de notificação, é importante que seu servidor tenha algumas configurações para atender a comunicação com mTLS para segurança da sua aplicação. Você encontra mais detalhes em nossa documentação e nos vídeos a seguir: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks
https://youtu.be/hdyUHzNwVLY?list=PLRqvcUTH2VsWufBmzOdTVeLEOTGrPNoiu
https://youtu.be/XB9bcZFTV3M?list=PLRqvcUTH2VsWufBmzOdTVeLEOTGrPNoiu

Um detalhe que você precisa conferir, é se você registrar a URL assim http://urldosite.com.br/notifications.php, ao acionar o webhook, será acrescentado um /pix na URL. Portanto, deve-se ser tratado a adição do /pix na URL.

Para solucionar isso, cadastre seu webhook URL com a query param ?ignorar=. Assim, quando o webhook for acionado, o /pix será tratado como um parâmetro e você receberá o JSON no arquivo notifications.php, conforme a seguinte URL: http://urldosite.com.b/notifications.php?ignorar=/pix.

Bom dia!
Atualmente, é necessário primeiro cadastrar a configuração de Split, depois emitir a cobrança e associar essa cobrança à configuração de Split previamente cadastrada.
Segue o fluxograma para uma visualização mais clara: https://dev.efipay.com.br/docs/api-pix/fluxogramas/#split-de-pagamento-pix

O endpoint de cadastro de webhook solicita o parâmetro da chave e este é obrigatório. Portanto, para cada chave Pix, será necessário realizar o cadastro do webhook, que pode ser a mesma ou uma URL diferente

Se precisar de mais alguma informação ou assistência, estou à disposição para ajudar!

Olá, estou estudando a api de pix do EfiPay, até o momento estou bem feliz com tudo que estou vendo. Mas ainda estou com algumas dúvidas que são mais para confirmar se eu realmente entendi bem tudo.

# PIX + Split de pagamento
Eu tenho intenção de usar o split de pagamento juntamente com PIX. Vi que existe uma forma onde eu crie uma split config no POST /v2/gn/split/config .
- Uma vez que eu criar uma split config, não existe uma forma onde eu consiga criar o pagamento PIX já com o split config em uma única requisição?
- Eu tenho que criar o PIX e então associar o split de pagamento previamente criado? (2 requisições)

# PIX Webhooks
Outra importante parte que precisarei integrar é a api de webhook, também vi que precisa cadastrar este event jutamente com uma chave PIX. Portanto se tiver 3 chaves, serão 3 subscriptions para escutar os updates relacionados a estas chaves.
- Existe uma forma onde eu possa registrar meu webhook globalmente ao invés de registrar por chave?

Olá, @diogo.f.m.7 e @rubenskuhl. Bom dia!

Gostaríamos de esclarecer que, conforme as normas do Banco Central, as notificações enviadas do PSP recebedor (no caso, a Efí) para o usuário recebedor trafegam utilizando o canal mTLS. Como parte desse protocolo, sempre enviamos o certificado nos webhooks, seja no cadastro ou na notificação de Pix.

Entendemos que em alguns cenários, como hospedagem em servidores compartilhados, pode haver restrições em relação à inserção de certificados. Por isso, disponibilizamos a opção skip mTLS, que permite o cadastro do webhook sem a necessidade do hand shake mTLS por parte do integrador. É importante destacar que, ao optar por utilizar o atributo skip mTLS, o integrador fica responsável por validar o nosso certificado, conforme as orientações que fornecemos.

Ressaltamos que sempre seguimos as diretrizes do Banco Central para garantir a segurança e conformidade de nossos serviços. 🧡

Até pq, uma opinião minha agr...
O webhook é o ponto "menos importante" pq a transação já aconteceu...

Uma forma de segurança q eu uso, pq vem da época de webhook q não tinha mtls, q é o caso do cartão e boleto, é quando recebo um webhook, não confiar nele, pego o id da transação e eu faço a consulta a api para validar o status...

Olá, @viniciusfebasse_37973! Pela configuração que você mencionou você está recebendo as notificações via webhook, é importante lembrar que as notificações são enviadas para a URL cadastrada + /pix

Bom dia! Tudo bem?
Se você registrar a URL assim http://urldosite/notifications.php, ao acionar o webhook, será acrescentado um /pix na URL. Portanto, no seu caso, a notificação seria enviada para http://urldosite/notifications.php/pix.

Para solucionar isso, cadastre seu webhook URL com a query param ?ignorar=. Assim, quando o webhook for acionado, o /pix será tratado como um parâmetro e você receberá o JSON no arquivo notifications.php, conforme a seguinte URL: http://urldosite/notifications.php?ignorar=/pix.

https://dev.efipay.com.br/docs/api-pix/webhooks#exemplos-de-configura%C3%A7%C3%B5es-de-servidor

Lá tem a importação da CA da Efí e configuração da CA no servidor web

Uma tentativa seria https://webhook.exemplo.com.br:9999 onde 9999 é a porta não padrão

Gente alguem tem ideia de como conseguir webhook em outra porta sem ser a padrão?

Eae pessoal, alguém já implementou o pix usando NestJS? se sim, qual estratégia adotou para o certificado publico do webhook? tenho em mente a possibilidade de criar um server https apontando para a porta 443 e definir as configs direto no server ou abstrair isso para uma camada superior criando um server nginx e configurar os certificados direto na máquina (ec2) ou até mesmo deixar o load balancer barrar e solicitar o certificado. Alguma ideia please? Agradeço

Mas especificamente do seu exemplo, não precisa tratar pix enviado e pix recebido no mesmo handler. Você pode criar uma chave Pix específica para o webhook do envio de Pix e tudo que chegar nele, tem a haver com envio. O que inclusive ajuda na portabilidade pois o envio de Pix não é parte da API Pix padrão.

Bom dia
consegui fazer todo o processo de cadastrar o webhook
porém ele não está registrando no arquivo json.
minha rota foi cadastrada com sucesso
mas ainda não está tendo o devido comportamento
meu servidor é apache2
java com spring bot
como eu faço pro servidor entender que quando a api mandar um put lá ele tem que ir pra aplicação?
eu tenho o jar lá e mesmo subindo o servidor ele não bate nas rotas desse jar
não entendo muito de infra alguém pode me ajudar?

@wiliambuzatto quando uma solicitação de envio de pix é feita com sucesso, ele retorna o endToEndId da transação. Esse endToEndId retornado neste momento é o mesmo que será enviado pelo webhook, quando a solicitação for realizada. Uma forma de manter esse controle no seu sistema seria, portanto, associar o idEnvio com este e2eid retornado no momento da solicitaçao. Desta forma, ao receber o webhook, conseguirá definir qual solicitação foi concluida.

boa tarde, já integramos a parte de pagamento via pix, precisando somente configurar o webhook, minha duvida é o seguinte, nossa API roda na porta 8080 por exemplo o servidor que configura o (cert, ca, e key) para meu dominio ele tem que rodar separado na porta 443 é isso? Passando o endpoint a qual vou configurar a webhookUrl