Histórico de mensagens sobre webhook pix

EXIBINDO CONVERSAS RECENTES:

Texto: webhook pix
# pix
Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

If you turn on the "pagador" information, the webhook will look like this:
{
"pix": [
{
"endToEndId": "E1803615022211340s08793XPJ",
"txid": "fc9a43k6ff384ryP5f41719",
"chave": "2c3c7441-b91e-4982-3c25-6105581e18ae",
"valor": "0.01",
"horario": "2020-12-21T13:40:34.000Z",
"infoPagador": "pagando o pix",
"gnExtras": {
"pagador": {
"nome": "GORBADOCK OLDBUCK",
"cpf": ".123.456-",
"codigoBanco":"00416968"
}
}
}
]
}

Note that you would still have to compare it to "devedor" to assess whether it's the same person or not. But if it's an issue pagador and devedor being different, you could set the account to deny such payments.

# pix
Avatar discord do usuario mantovani3653

mantovani3653

Nas minhas rotas tem cadastrado o sufixo /api


Route::post("/webhook", [WebhookController::class, "handle"]);

Route::post("/webhook/pix", [WebhookController::class, "handle"]);

# pix
Avatar discord do usuario mantovani3653

mantovani3653

Ver Respostas

Boa tarde, tudo bem. No trecho de código de configuração do webhook eu cadastrei sem o sufixo. Não seria isso o certo?

public function pixConfigWebhook() {
$params = [
"chave" => env("EFI_PIX")
];

$body = [
"webhookUrl" => "https://meudominio.com.br/api/webhook" # exemplo de como eu fiz
];

$response = $this->api->pixConfigWebhook($params, $body);
}

# pix
Avatar discord do usuario marcelo_efi

marcelo_efi

Ver Respostas

Boa tarde, tudo bem?

Um detalhe importante sobre a URL do webhook:
Após o cadastro da URL, toda notificação de pagamento enviada para ela terá o sufixo /pix adicionado automaticamente ao final da URL salva.

Você cadastrou a URL com o /pix ou sem?

# pix
Avatar discord do usuario mantovani3653

mantovani3653

Ver Respostas

Boa tarde, estou com problemas nas notificações dos webhooks.
Meu sistema está em produção, o webhook está registrado corretamente para a chave PIX (verificado pela API), e os pagamentos via QR Code são realizados. Porém, nenhum evento é disparado na rota /api/webhook/pix (a registrada). Apenas o evento de teste é recebido:

production.INFO: Requisição recebida: {"evento":"teste_webhook","data_criacao":"2025-01-09T15:41:04.960Z"}

Estou utilizando o Laravel com o sdk-php-apis-efi. Minhas rotas estão configuradas assim:

Route::post("/webhook", [WebhookController::class, "handle"]);
Route::post("/webhook/pix", [WebhookController::class, "handle"]);

Alguém poderia me dar uma sugestão de como resolver esse problema?

# pix
Avatar discord do usuario igor_efi

igor_efi

Ver Respostas

Boa tarde, @lucianoolegario_57079! Tudo bem?
O cadastro da URL é feito em outro endpoint: PUT /v2/webhook/:chave
Você pode consultar mais informações em nossa documentação: https://dev.efipay.com.br/docs/api-pix/webhooks

# pix
Avatar discord do usuario palloma_efi

palloma_efi

Ver Respostas

Boa tarde, @lucianoolegario_57079 ! Tudo bem? Quando você ou o seu sistema faz uma solicitação para gerar um QR Code, nossa API recebe essa requisição contendo as informações necessárias. Com base nos dados enviados, a API processa a solicitação, gera o QR Code e devolve o resultado na resposta da requisição. Esse QR Code estará pronto para ser exibido ou utilizado diretamente no seu sistema.

Também contamos com um sistema de notificações em tempo real utilizando webhooks. O webhook é responsável por avisar o seu sistema sempre que identificamos o pagamento de uma cobrança PIX.

Funciona assim: após o QR Code ser gerado e enviado para o cliente final, o nosso sistema monitora automaticamente o pagamento dessa cobrança. Assim que o pagamento é confirmado, enviamos uma notificação para a URL que você definiu, contendo todas as informações do pagamento.

# pix
Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

Tudo bem também!
Beleza! Um detalhe, é que as notificações de Pix são enviadas para a URL registrada com um /pix no final. Ou seja, se você registrou a URL https://seudominio.com.br/webhook/, a notificação será enviada para https://seudominio.com.br/webhook/pix. Então, você precisa tratar essa rota /webhook/pix na sua aplicação

Outra opção é cadastrar a URL do webhook com um query param para ignorar a adição do /pix, assim:https://seudominio.com.br/webhook/?ignorar=

# pix
Avatar discord do usuario aguinelequeiroz

aguinelequeiroz

Ver Respostas

Tudo bem e você? Como esta?

Quando cadastro a url do webhook recebo esse evento de teste:

{
"evento": "teste_webhook",
"data_criacao": "2025-01-08T12:10:23.151Z"
},

Porém, quando realizo um teste, enviando uma solicitação de envio de pix(exemplo da doc não associado a um txid) eu não recebo nenhuma notificação sobre.
Estou usando o sdk php em uma aplicação Laravel 9.

# pix
Avatar discord do usuario guilherme_efi

guilherme_efi

Ver Respostas

Bom dia, @aguinelequeiroz! Como vai?
Sim, você recebe o callback. Para enviar Pix via API, é obrigatório ter o webhook cadastrado. Assim, sempre que uma solicitação de envio for feita, seu sistema receberá uma notificação com a confirmação ou recusa da transação.

Confira o exemplo na nossa documentação: https://dev.efipay.com.br/docs/api-pix/webhooks#requisi%C3%A7%C3%A3o

# pix
Avatar discord do usuario aguinelequeiroz

aguinelequeiroz

Ver Respostas

Bom dia,

Quando faço uma solicitação de envio de pix na API eu recebo uma callback no webhook, caso ele esteja configurado? Ou para envio de pix não há callbacks via webhook?

# pix
Avatar discord do usuario bras6379_26227

bras6379_26227

Ver Respostas

Pessoal, como eu posso correlacionar o webhook de pix pago com o pix que eu gerei inicialmente? existe um id unico pra esse pix que eu posso usar pra correlacionar o pix copia e cola gerado com o pix pago? mt obrigado desde ja!
Seria esse o txid?

A documentacao mostra esse payload do webhook:
// Pix recebido
{
"pix": [
{
"endToEndId": "E1803615022211340s08793XPJ",
"txid": "fc9a43k6ff384ryP5f41719",
"chave": "2c3c7441-b91e-4982-3c25-6105581e18ae",
"valor": "0.01",
"horario": "2020-12-21T13:40:34.000Z",
"infoPagador": "pagando o pix"
}
]
}

E esse payload do pix gerado
{
"calendario": {
"criacao": "2020-09-09T20:15:00.358Z",
"expiracao": 3600
},
"txid": "7978c0c97ea847e78e8849634473c1f1",
"revisao": 0,
"loc": {
"id": 789,
"location": "pix.example.com/qr/v2/9d36b84fc70b478fb95c12729b90ca25",
"tipoCob": "cob"
},
"location": "pix.example.com/qr/v2/9d36b84fc70b478fb95c12729b90ca25",
"status": "ATIVA",
"devedor": {
"cnpj": "12345678000195",
"nome": "Empresa de Serviços SA"
},
"valor": {
"original": "567.89"
},
"chave": "a1f4102e-a446-4a57-bcce-6fa48899c1d1",
"solicitacaoPagador": "Informar cartão fidelidade",
"pixCopiaECola": "00020101021226830014BR.GOV.BCB.PIX2561qrcodespix.sejaefi.com.br/v2/41e0badf811a4ce6ad8a80b306821fce5204000053000065802BR5905EFISA6008SAOPAULO6007050361040000"
}

# devs
Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

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

# pix
Avatar discord do usuario joaolucas_efi

joaolucas_efi

Ver Respostas

Bom dia, @artesa.maluca. Tudo bem?
Como esta cadastrando sua URL?
Pelas suas configs, é de fato esperado um erro, já que esta fazendo um looping na rota /api/webhook/efi/pix.

# pix
Avatar discord do usuario artesa.maluca

artesa.maluca

Ver Respostas

Boa tarde, estou tentando configurar o mTLS para cadastrar o wwebhook da chave pix, estou usando nginx com PHP, ja configurei o .cong do nginx e está da seguinte forma

server {
server_name {URL_BASE};
root /var/www/html/public;
listen [::]:443 ssl ipv6only=on;
listen 443 ssl;

ssl_certificate /etc/letsencrypt/live/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/privkey.pem;

ssl_dhparam /etc/ssl/certs/dhparam.pem;
ssl_client_certificate /etc/nginx/ssl/chain-pix-webhooks-prod.crt;
ssl_verify_client optional;
ssl_verify_depth 3;

add_header X-Frame-Options "SAMEORIGIN";
add_header X-XSS-Protection "1; mode=block";
add_header X-Content-Type-Options "nosniff";

index index.html index.htm index.php;

charset utf-8;

location / {
try_files $uri $uri/ /index.php?$query_string;
}

location = /favicon.ico { access_log off; log_not_found off; }
location = /robots.txt { access_log off; log_not_found off; }

error_page 404 /index.php;

location ~ \.php$ {
fastcgi_pass unix:/var/run/php/php8.1-fpm.sock;
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $realpath_root$fastcgi_script_name;
include fastcgi_params;
}

location ~ /\.(?!well-known). {
deny all;
}

location /api/webhook/efi/pix {
if ($ssl_client_verify != SUCCESS) {
return 403;
}
proxy_pass {URL_BASE}/api/webhooks/efi/pix;
}
}
Ao tentar deixar o proxy_pass sem a url junto, ele da erro ao tentar iniciar o nginx
Jan 02 19:01:22 ip-172-31-42-174 nginx[3444869]: nginx: [emerg] invalid URL prefix in /etc/nginx/sites-enabled/default:86
Jan 02 19:01:22 ip-172-31-42-174 nginx[3444869]: nginx: configuration file /etc/nginx/nginx.conf test failed

# pix
Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

É via configuração do webhook.
https://dev.efipay.com.br/docs/api-pix/endpoints-exclusivos-efi#criarmodificar-configura%C3%A7%C3%B5es-da-conta

chave -> notificacao -> pagador

{
"pix": {
"receberSemChave": true,
"chaves": {
"355e4568-e89b-1243-a456-006655440001": {
"recebimento": {
"txidObrigatorio": false,
"recusarTipoPessoa": "PF",
"qrCodeEstatico": {
"recusarTodos": false
},
"documentoPagadorIgualDevedor": true,
"webhook": {
"notificacao": {
"tarifa": true,
"pagador": true
},
"notificar": {
"pixSemTxid": true
}
}
},
"envio": {
"webhook": {
"notificacao": {
"tarifa": true,
"favorecido": true
}
}
}
}
}
}
}

# dúvidas
Avatar discord do usuario fred4631

fred4631

Galera, alguem sabe qual roadmap eu devo seguir para identificar via webhook no n8n que uma cobrança PIX imediata foi paga ?

# pix
Avatar discord do usuario joaolucas_efi

joaolucas_efi

Ver Respostas

Bom dia, @euleonardov. Tudo bem?

Via API não é possível gerar um QR Code estático, mas isso pode ser feito através da Conta Digital, basta ir ao menu "Pix" -> "Gerar QR Code". E então pode configurar via API um webhook para a chave Pix utilizada para que você receba as informações de um Pix sem txid, que será o caso de pagamentos como esse.

Para habilitar o recebimento de webhooks para Pix sem txid você deve consumir o endpoint PUT /v2/gn/config atribuindo para sua chave a propriedade webhook.notificar.pixSemTxid como true.

Se tiver alguma dúvida, é só nos chamar por aqui!

# pix
Avatar discord do usuario joao_efi

joao_efi

Boa tarde @conexao_cefet
A API Pix só dispara webhook em casos de Pix recebido, devolvido ou enviado (transferência via API)
Você pode verificar acessando o menu "API" > "Aplicações" e selecionando a aplicação criada

Na nossa documentação você encontra mais detalhes: https://dev.efipay.com.br/docs/api-pix/webhooks#recebendo-callbacks