Histórico de mensagens sobre webhook pix em devs

Desses o único que tenha a te dar enrosco para webhook da API Pix é a Cloudflare.

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?

Passei pelo mesmo, entao alterei o checkout para o shortcode mas recebo erro ao tentar pagar no pix, com cadastro novo, preciso passar pelas ids de homologacao antes de ativar para o cliente?

2024-12-10 16:43:46 Efi-Log:: Exception: Erro interno do servidor. in /var/www/wptbox/wp-content/plugins/woo-gerencianet-official/includes/lib/class-gerencianet-integration.php:438
Stack trace:
#0 /var/www/wptbox/wp-content/plugins/woo-gerencianet-official/includes/lib/class-gerencianet-integration.php(257): Gerencianet_Integration->result_api()
#1 /var/www/wptbox/wp-content/plugins/woo-gerencianet-official/includes/payment-methods/class-wc-gerencianet-pix.php(445): Gerencianet_Integration->update_webhook()
#2 /var/www/wptbox/wp-includes/class-wp-hook.php(324): WC_Gerencianet_Pix->registerWebhook()
#3 /var/www/wptbox/wp-includes/class-wp-hook.php(348): WP_Hook->apply_filters()
#4 /var/www/wptbox/wp-includes/plugin.php(517): WP_Hook->do_action()
#5 /var/www/wptbox/wp-content/plugins/woocommerce/includes/admin/settings/class-wc-settings-payment-gateways.php(315): do_action()
#6 /var/www/wptbox/wp-includes/class-wp-hook.php(324): WC_Settings_Payment_Gateways->save()
#7 /var/www/wptbox/wp-includes/class-wp-hook.php(348): WP_Hook->apply_filters()
#8 /var/www/wptbox/wp-includes/plugin.php(517): WP_Hook->do_action()
#9 /var/www/wptbox/wp-content/plugins/woocommerce/includes/admin/class-wc-admin-settings.php(84): do_action()
#10 /var/www/wptbox/wp-content/plugins/woocommerce/includes/admin/class-wc-admin-menus.php(179): WC_Admin_Settings::save()
#11 /var/www/wptbox/wp-includes/class-wp-hook.php(324): WC_Admin_Menus->save_settings()
#12 /var/www/wptbox/wp-includes/class-wp-hook.php(348): WP_Hook->apply_filters()
#13 /var/www/wptbox/wp-includes/plugin.php(517): WP_Hook->do_action()
#14 /var/www/wptbox/wp-settings.php(726): do_action()
#15 /var/www/wptbox/wp-config.php(124): require_once('...')
#16 /var/www/wptbox/wp-load.php(50): require_once('...')
...

Bom dia! Tudo bem?

Você pode receber o nome do pagador no webhook. Para isso, primeiro é preciso habilitar essa configuração.

Basta usar o endpoint https://dev.efipay.com.br/docs/api-pix/endpoints-exclusivos-efi#criarmodificar-configurações-da-conta">PUT /v2/gn/config (Criar/modificar configurações da conta), enviando o JSON com a configuração associada à chave Pix que será usada nas cobranças Pix. Para incluir os dados do pagador, como o nome, adicione o parâmetro webhook.notificacao.pagador = true.

Assim, nossa API envia uma notificação parecida com esta:

Bom dia, @413749917396238336! Tudo bem?

Para receber essa informação pelo webhook, primeiro é preciso habilitar essa configuração. Para isso, use o endpoint PUT /v2/gn/config (Criar/modificar configurações da conta), enviando o JSON com a configuração associada à chave Pix que será usada nas cobranças. Para receber os dados do pagador, incluindo o banco utilizado, adicione o parâmetro webhook>>notificacao>>pagador=true.

Depois de fazer essa configuração, as notificações incluirão o atributo gnExtras>>pagador, com o codigoBanco. Esse código do banco pode ser identificado na lista disponibilizada pelo Banco Central.

Boa tarde @caiquegarcia. ! Você pode utilizar o endpoint de exibir informações do webhook Pix, passando sua chave pra ver se vai retornar algum webhook?

Bom dia, @kevencampos! Tudo bem?
Existem algumas diferenças no JSON enviado em uma transação de Pix recebido e Pix enviado.

Primeiro, como o Rubens mencionou, você pode usar uma chave Pix para recebimento e outra para envio, usando o mesmo webhook URL. Dessa forma, ao receber a notificação, você já pode diferenciar pela chave.

Outro ponto que pode verificar é que o JSON de Pix enviado possui o parâmetro "tipo": "SOLICITACAO", além disso, tem também o parâmetro gnExtras>idEnvio.

Veja em nossa documentação alguns exemplos de JSON: https://dev.efipay.com.br/docs/api-pix/webhooks#requisi%C3%A7%C3%A3o

Pessoal, alguem pode me ajudar ? no webhook, como posso saber a origem da notificação ? se é de pagamento, devolução ou envio ?
https://dev.efipay.com.br/docs/api-pix/webhooks

Bom dia pessoal da Efi.

Venho avisar sobre uma pequena inconsistência nos dados enviados no webhook de pix recorrente via opex-banking:

Aqui eu extrai os payloads e modifiquei os ids:

No envio do payload para assinatura ativa e atualizações de pagamento aceite, o status enviado pela EFI está como "ACEITE".
Entretanto, no envio do ultimo payload, no último dia da assinatura, é enviado um payload informando que a assinatura está concluída, mas com o status dos pagamentos como "ACEITO" .

Seria legal se pudessem normalizar seja como "aceite", ou como "aceito"

Abs

{
"identificadorPagamento": "abc_123",
"valor": "0.99",
"status": "ativa",
"dataCriacao": "2024-09-24T10:23:24.890Z",
"recorrencia": [
{
"endToEndId": "payment_1",
"status": "aceite",
"dataOperacao": "2024-09-25"
},
{
"endToEndId": "payment_2",
"status": "agendado",
"dataOperacao": "2024-09-26"
},
{
"endToEndId": "payment_3",
"status": "agendado",
"dataOperacao": "2024-09-27"
}
],
"idProprio": "173abce6-e7d8-400c-bf6e-db0d0c3628f7",
"tipo": "recorrencia"
}

"identificadorPagamento": "abc_123",
"valor": "0.99",
"status": "concluida",
"dataOperacao": "2024-10-10",
"dataCriacao": "2024-10-07T09:53:53.000Z",
"recorrencia": [
{
"endToEndId": "payment_1",
"status": "aceito",
"dataOperacao": "2024-10-08"
},
{
"endToEndId": "payment_2",
"status": "aceito",
"dataOperacao": "2024-10-09"
},
{
"endToEndId": "payment_3",
"status": "aceito",
"dataOperacao": "2024-10-10"
}
],
"idProprio": "f5e75088-1a10-4f79-81b7-da5ee0e846a6",
"tipo": "recorrencia"
}

Olá, eu criei o servidor webhook com certificado configurado no virtual host do apache e o arquivo php no diretório e subdomínio apontado, quando gerar um pix aonde coloco a url de retorno dentro do json ou como cadastro a url do webhook, no mercadopago cada transação que faço informo a url de retorno em cada transação pix, só funciona via SDK ou posso fazer tudo com CURL ?

Salve galera, alguem ai conseguiu desenrolar o webhook recebimento pix em C# .NET ?
Puder mandar um repo ou chamar no pv Deus vai abençoar

Boa tarde, alguém saberia me dizer se existe uma doc com os payloads enviados pelos webhooks nos eventos de PIX ?

Bom dia, @wilianmaique, tudo bem?

Esses padrões de segurança são orientações do Bacen (Banco Central), no caso do envio de Pix via API é um recurso delicado que permite uma vazão de valor alta, não sendo justificada para uma PF, mas sim para uma PJ onde há registros de documentação que evidenciam o uso destes valores.
Com relação ao webhook, nossa API segue o manual de integração imposto pelo Bacen, que pede que a implementação do webhook seja feita desta forma, implementar de uma forma distinta dessa seria não seguir o manual de integração do Bacen quanto ao Pix, você pode conferir esse documento aqui.

Caso tenha alguma dúvida basta nos perguntar para que possamos lhe auxiliar da maneira mais assertiva possível.

eu vi sobre o webhook tmb, precisar cadastrar webook, acho 'paia' tmb, é mais dinamico na criação do pix informar a URL e pronto

Boa noite, @alandias_00502! O webhook para pagamentos segue às características da API que faz referência, como segue:
Documentação de webhooks na API de Pagamentos;
Documentação de webhooks no envio de PIX, API PIX, recurso PIX-Send (Cash-out).

Boa noite. Existe a possibilidade de criar um webhook para pagamentos igual há no PIX ou apenas inserindo notification_url em cada cobrança?

Oi, @fe0068. Bom dia! Tudo bem?
A segunda requisição que é feita no cadastro do webhook é enviada para a URL que você está tentando registrar, adicionando /pix no final.

Ou seja, se você está registrando https://seudominio.com.br/notification/efipay, a segunda requisição será para https://seudominio.com.br/notification/efipay/pix, então é importante tratar isso também.

Outra opção é registrar com um query param, assim: https://seudominio.com.br/notification/efipay/?ignorar=, para ignorar o /pix no final.

Bom dia, @weslly99, tudo bem?
1. Sim, o certificado faz referencia a conta, funcionando de forma semelhante a uma credencial.
2. Você deve ser capaz de distinguir quem esta recebendo a notificação, você pode fazer isso tendo URL distintas, usando apenas query params para distinguir, etc.
3. É importante garantir que os usuários terão acesso apenas ao que é devido à eles, ou seja, que não consigam influenciar na cobrança de outros usuários. Restrinja ao máximo os acessos aos bancos que conterão as credenciais e os certificados para evitar que outras pessoas vazem estes dados. Ao implementar o webhook Pix, utilize o mTLS e/ou HMAC para garantir que a comunicação esteja sendo de fato feita pelos servidores da Efí.

Caso tenha alguma outra dúvida basta nos perguntar para que possamos lhe auxiliar da maneira mais assertiva possível.

Boa tarde pessoal, vocês tem um exemplo de configuração do webhook e webhook/pix utilizando as rotas do laravel ?
Fiz as seguintes configurações, mas estou tendo erro ao executar a rota