Histórico de mensagens sobre webhook pix

Sim, dá para usar webhook.
https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks

eu recebo o webhook de pix recebido

@huggler6815, para maior performance do envio de Pix, e visando evitar a colisão de movimentações de saldo, sugerimos que o envio de Pix por API seja condicionado à conclusão da transação anterior, que se dá pelo webhook. Pois seguindo nosso fluxo da confirmação do Pix, primeiramente o valor é creditado na conta, para depois acionar seu webhook.

De qualquer forma é interessante consultar seu saldo antes de realizar o envio para saber se realmente tem saldo disponível, pois deve considerar que ao receber um Pix é descontado a tarifa, e ao enviar também.

Mas a descrição que a Efí tinha me passado era de que a mudança de status do /cob, a chamada do webhook e o acréscimo de saldo aconteciam todos no mesmo momento. Que a única coisa que acontece um pouco antes é a mudança de status do /pix.

Fala galera! Baaaum? [REPOSTANDO]

Resolvi o erro ERR_TLS_CERT_ALTNAME_INVALID ao usar API Gateway da AWS.
Após assistir ao tutorial do @danielciolfi, fiz o mesmo procedimento com um domínio registrado externamente, no meu caso namecheap, mas ao tentar registrar a Webhook o erro ERR_TLS_CERT_ALTNAME_INVALID era retornado. Tentei de tudo, gerar novo certificado sem wildcard("."), refazer truststore.pem, gerar certificado direto no “api.” mas não funcionava. Percebi também que ao acessar diretamente pelo navegador, o certificado era sempre relacionado ao domínio principal, e nunca ao “api.”.

Ai lendo algumas soluções aqui no Discord, como a do Ranulfo souza, resolvi fazer da seguinte forma e resolveu:

0 - (Opcional) Antes de começar, recomendo apagar tudo que foi feito, exceto pela API Gateway e o truststore.pem gerado.
(Deletei o nome de domínio personalizado, removi os registros no namecheap e deletei os certificados criados);

1 - Comprar um domínio no Google Domains só para esse uso;
Domínio fictício para fins didáticos: pixok.com

2 - Na AWS, em Route 53, criar nova zona hospeda e no nome do domínio, inserir o domínio comprado (pixok.com) e criar zona;

3 – Ao navegar na zona criada, você vai ver o registro do tipo NS com os links, ai é só adicionar todos no Google Domains em Servidores de nome personalizados do seu domínio. Por padrão, o Google não usa os nomes personalizados, ai é só clicar em aplicar na aba Servidores de nome personalizados;

4 – Criar certificado com o nome api.pixok.com, navegar até o certificado, clicar em Criar registros no Route 53 e confirmar clicando em criar. Isso fará o certificado ser verificado;

5 – Após o certificado ser verificado, ir na API Gateway e criar nome de domínio personalizado com o nome api.pixok.com, selecionando o novo certificado. E também já configurar o mapeamento de API para sua API;

6 – Em Route 53, na zona hospedada, no domínio pixok.com, criar novo registro com as seguintes informações:
- Nome do registro: api
- Tipo de registro: A
- Ativar Alias
- Escolher endpoint para: Alias para API do API Gateway
- Escolher o servidor que você está trabalhando, no meu caso “us-east-1”
- E no terceiro campo que aparecer, já vai carregar automaticamente o
“Nome de domínio do API Gateway” que você encontra no domínio personalizado que criou.
Ai é só finalizar criando o registro e aguardar a propagação que pode levar alguns minutos, no meu caso levou mais de 5 minutos.

7 – Antes de ativar o TLS mútuo no domínio personalizado, eu fiz testes solicitando POST com o postman para api.pixok.com/prod/webhook até ter algum retorno, assim eu sei que toda configuração acima tá funcionando corretamente e foi propagado.

8 – Ativar TLS mútuo como feito anteriormente, aguardar o status ficar ativo e testar o registro da webhook com o seu link 😊


Obrigado Ranulfo souza e a todos que comentaram sobre o assunto. 👊

Para o Envio de Pix, endpoint PUT /v2/gn/pix/:idEnvio :

Se o valor do Pix está entre R$ 0.01 à R$ 10.00:
Pix é confirmado, informação virá via Webhook.
Se o valor do Pix está entre R$ 10.01 à R$ 20.00:
Pix é rejeitado, informação virá via Webhook.
Se o valor do Pix é acima de R$ 20.00:
Pix é rejeitado já na requisição, informação não virá via Webhook.

O que é curioso é que na nossa experiência, o webhook chega já junto com o saldo. O GET de /pix consegue ver o Pix antes, mas o webhook e o GET de /cob chegam juntos do crédito na conta. Mas se vc reportou isso, deve ter acontecido com você...

Em seu domínio que representa o seu servidor, deverá ser feita uma configuração para exigir a chave pública (https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt) para que ocorra a autenticação mútua. Disponibilizamos alguns exemplos de configuração de servidor na nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#exemplos-de-configura%C3%A7%C3%B5es-de-servidor

eu preciso baixar aquele certificado e por onde? https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt

Para cadastrar uma URL de webhook, você vai precisar consumir a rota PUT /v2/webhook/:chave. Mais detalhes por aqui: https://dev.gerencianet.com.br/docs/api-pix-endpoints#configurar-o-webhook-pix

Bom dia, @nemtudo.
Exatamente como o Rubens mencionou. Os callbacks são enviados pela Efí via POST ​/pix sempre quando houver uma alteração no status do Pix.
https://dev.gerencianet.com.br/docs/api-pix-endpoints#recebendo-callbacks

Se vc cadastra o webhook em exemplo.com.br/webhook, o acionamento se dá em exemplo.com.br/webhook/pix

Bom dia, @nicolasmatos.
Você pode consumir o endpoint PUT /v2/gn/config e definir o recebimento via webhook, o valor da tarifa Pix cobrada.
Segue detalhes do endpoint: https://dev.gerencianet.com.br/docs/api-pix-endpoints#criarmodificar-configura%C3%A7%C3%B5es-da-conta

Você receberá a notificação como na seguinte imagem.

Há três jeitos:
- Webhook
- GET de /cob, ver se tem o bloco pix
- GET de /pix com filtro por início/termino/txid

O melhor é um combo de webhook com um recuperador fazendo GET de /pix se o webhook não tiver sido recebido.

Boa tarde, @notrevedr! Tudo bem?

O ngrok te permite configurar o uma chave pública da Efí em seu servidor para que a comunicação obedeça o padrão mTLS?
https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks

Outro detalhes é a adição do /pix no final da URL.
Ou seja, na request PUT https://api-pix.gerencianet.com.br/v2/webhook/:chave você irá passar o body com sua URL, exemplo:

qual é o tempo + ou - que leva pra um PIX bater na conta da gerencianet?

Exemplo: um cliente pagou um PIX e eu recebi esse aviso no webhook.... e todo recebimento, eu faço um repasse usando o pixSend....

O problema que eu detectei é que quando eu fui fazer o pixSend, retornou que não tinha saldo suficiente... e isso me intrigou... pois tinha acabado de receber um pagamento!

Como assim "pega" ? Existe um endpoint /v2/webhook que é usado para configurar uma URL para cada chave Pix que você tenha.

onde eu pego o webhook do pix na gerencia net

Sim atende! Inclusive já tinha lido. Mais tem uma informação que preciso que me oriente melhor:

A parte que fala sobre:
Webhook

Para utilização do endpoint de Requisitar envio de Pix, além da liberação do escopo pix.send é necessário que a chave Pix do pagador tenha um webhook associado a mesma, pois, será por meio do webhook que a Efí vai informar a você se o envio de pix foi realizado com sucesso ou não.

OBS: Para maior performance de uso do serviço, e visando evitar a colisão de movimentações de saldo, sugerimos que o envio de Pix por API seja condicionado à conclusão da transação anterior, que se dá pelo webhook. Caso a prática anteriormente citada não seja adotada, quando múltiplas requisições de envio forem feitas simultaneamente, o integrador poderá experimentar falhas no envio.

O que seria essa liberação do escopo pix.send?

Se o Pix foi pago a partir do QR-Code, o PSP pagador enviou txid e chave Pix, e há um webhook cadastrado para essa Pix: sim, é impossível.