Histórico de mensagens sobre webhook pix

Se veio um webhook com objeto Pix, foi pago e o status é CONCLUIDO.

se puder me tirar uma duvida dos callbacks dos webhooks da api pix, estou dando uma lida na documentação e não encontro onde ele retorna o status do pix, não vejo os status das alterações.

Bom dia, @kvtwetfps! Como vai?
Como o Rubens mencionou, você pode usar o endpoint https://dev.efipay.com.br/docs/api-pix/endpoints-exclusivos-efi#criarmodificar-configurações-da-conta">PUT /v2/gn/config para habilitar a configuração webhook.notificacao.pagador=true que permite receber no webhook o nome e o CPF mascarado do pagador, conforme exemplo abaixo:

Se você habilitar a configuração de receber dados do pagador, vem no webhook.
{
"pix": {
"receberSemChave": true,
"chaves": {
"355e4568-e89b-1243-a456-006655440001": {
"recebimento": {
"txidObrigatorio": false,
"recusarTipoPessoa": "PF",
"qrCodeEstatico": {
"recusarTodos": false
},
"webhook": {
"notificacao": {
"tarifa": true,
"pagador": true
},
"notificar": {
"pixSemTxid": true
}
}
},
"envio": {
"webhook": {
"notificacao": {
"tarifa": true,
"favorecido": true
}
}
}
}
}
}
}

Multi-tenancy não é problema pro mTLS, pq as chamadas para todos os clientes Efí usam a mesma CA (CA privada da Efí) e mesmo CN (gn-webhook-pix), etão você pode usar a mesma configuração para todos.

No webhook vem a chave Pix, e cada chave Pix é de um client... então você já tem uma informação para diferenciar os tenants, e pode usar até mesmo a exata mesma URL para tudo. Agora, dá para adicionar um parâmetro do webhook que vc configura em cada chave Pix para ter um double check. Poderia ser por exemplo:
"https://webhookefi.zonkof.com.br/?tenant-id=xxxxxx&ignorar="

O ignorar= é pq a Efí vai adicionar um /pix no final.

Galera, minha API utiliza uma abordagem multi-tenancy, ou seja, é uma unica API que atende a vários bancos de dados, cada banco de dados (Entenda cada banco de dados, como uma empresa que contrata o meu sistema.)
Estou utilizando o cloud run do GCP para hospedar a API, e quero configurar o webhook de pix, porém vi que precisa adicionar uns certificados na configuração do nginx/apach/express etc.. e tem que fazer algo relacionado aos certificados ssl da API e tal.. porém, como está no gcp, isso ficaria dificil. Entao gostaria de utilizar a abordage do Skip-mTLS...

Como mencionei acima, minha aplicação é multi-tenancy, e existe um middleware na minha API que recebe na requisição um parametro chamado "x-tenant-id" (atualmente é um header, mas pode ser qualquer coisa que funcione kk). Então gostaria de saber como eu poderia proceder para que em todas as requisições do webhook que a EFI mandará para a minha API, tenha algum identificador para que possa fazer a orquestração de qual banco de dados realizarei as consultas aqui.. Poderiam me ajudar com isso?

Só queria ativar a opção recebimento.webhook.notificar.pixSemTxid, não tem uma opção pra isso fora da API, direto na conta/web?

Poderia por favor me indicar exatamente qual é a opção que preciso marcar para ter acesso ao escopo gn.settings.write a fim de conseguir configurar a opção recebimento.webhook.notificar.pixSemTxid ? Estou na tentativa e erro aqui há muito tempo! Grato.

Olá, @gabrielkaka123. Bom dia! Tudo bem e com você?

A forma ideal de verificar os pagamentos de cobranças Pix é usando um webhook. Para isso, você configura através do endpoint PUT /v2/webhook/:chave, uma URL do seu site associada à chave Pix usada nas cobranças. Assim, quando uma cobrança for paga, a API do Efí envia automaticamente uma notificação para sua URL com um JSON contendo as informações do Pix.

Entre essas informações estará o txid (identificador do Pix que você emitiu). Com isso, você poderá fazer a conciliação e realizar processos como o envio do e-mail que deseja.

Se tiver qualquer outra dúvida, conte com a gente!

Seu webhook atende só na URL cadastrada ou também em URL+"/pix" ?

Bom dia, @bgeneto. Tudo bem?
Hoje não fornecemos um endpoint que traga diretamente o comprovante, mas você pode montar um comprovante com base nas informações que você tem da transação, se você verificar o comprovante apresentado em sua Conta Digital verá que tem a maior parte dos dados presente nele, portanto pode montar um documento semelhante.
Com relação ao webhook, é possível sim, basta você configurar o webhook para a chave desejada através do endpoint descrito aqui e enviar a opção recebimento.webhook.notificar.pixSemTxid como true no endpoint de configuração de conta, descrito aqui, assim você receberá um webhook para todos recebimentos de valores para a chave configurada.

Caso tenha alguma dúvida, basta nos chamar por aqui.

Outra dúvida: existe possibilidade de cadastrar um webhook sempre que a entrada de dinheiro na conta por uma determinada chave PIX for feita?

Fala pessoal, tô tentando configurar webhook para ouvir os eventos de pix, porém estou recebendo esse da imagem 2.

Tentei ver com o GPT como fazer essa autenticcação, mas não foi útil.

Estou usando N8N, alguém poderia me ajudar?

pessoal preciso criar esse certificado CA, estou fazendo a configuração de webhook do retorno do pix

Boa tarde @helderandre ! No caso, você utiliza o N8N para emitir suas cobranças também? E ja possui um servidor configurado para receber as notificações? Porque nesse caso, você teria apenas que cadastrar seu webhook, utilizando o endpoint de configurar o webhook.

Fala galera, qual a forma que vocês tem utilizado para receber notificações de status de pagamento via Webhook? Atualmente utilizo apenas pix como forma de cobrança.

O Banco Central definiu webhook como padrão para Pix. Não é escolha da Efí.

Além do webhook, na prática você já tem a instituição do pagador. O E2Eid do Pix tem os primeiros dígitos depois do E como o ISPB do participante que enviou o Pix.

Meu servidor é compartilhado. Estou com dificuldades em receber o webhook. Seria mais fácil se o pix tivesse também o notification_url.

como testar o webhook do pix local com o exemplo do flask