Histórico de mensagens sobre webhook | Canal pix | Página 175

joaolucas_efi

13/11/2023

Bom dia @allanmello, tudo bem?
Uma solução que talvez atenda seu caso seja a adição de um hmac para acessar sua URL.
Você pode dar um olhada nisso em https://dev.efipay.com.br/docs/api-pix/webhooks/#entendendo-o-padr%C3%A3o-mtls

allanmello

13/11/2023

Bom dia, minha API possui uma ApiKey de segurança, ou seja para acesso externo a minha API o Header tem que enviar a ApiKey, tem como registrar essa ApiKey no cadastro da minha webhook para a Efí enviar no header?
Eu li um tempo atrás que tem como fazer isso, mas procurei e não encontrei na doc na hora de registrar o webhook.

_ganimedes

13/11/2023

Bom dia,
Estou com problema na hora de enviar a URL de configuracao do pix
estou recebendo o seguinte erro
error {
nome: 'webhook_invalido',
mensagem: 'A URL informada respondeu com o código HTTP 403'
}

rubenskuhl

13/11/2023

Então, como você já você viu, a Efí aciona o webhook se o valor em homologação for de até R$10. Então a forma de testar é essa.

vinicius_cs

13/11/2023

É que eu queria alterar o status para pago pra poder testar o webhook, gerei um Pix com qrcode no meu site, gostaria de "pagar" ele e ver se o webhook está funcionando corretamente

rubenskuhl

13/11/2023

Além do webhook, o que você quer dizer como simulação de pagamento ? Se for aparecer o objeto pix no /cob, a Efí ainda não faz isso em homologação.

rubenskuhl

13/11/2023

É que os dois cenários de webhook são esses... ou o cliente vai pagar, ou o cliente não vai pagar. O valor é só para escolher qual cenário você vai testar.

Agora, mais de 1 quatrilhão de Reais eu não sei se funciona, só recebi Pix de 1 quatrilhão... só o Tio Patinhas para fazer Pix de 1 quaquilhão.

vinicius_cs

13/11/2023

Bom dia, pagamentos acima de R$10,00 o Webhook não funciona? 😕

vinicius_cs

É possível testar Webhook em homolog?

Estou desenvolvendo em Laravel, fiz a rota com o /webhook, no entanto ao executar:
https://pix-h.api.efipay.com.br/v2/webhook/:chave

É retornado:
{
"nome": "webhook_invalido",
"mensagem": "A URL informada respondeu com o código HTTP 419"
}

No WebhookController eu coloquei apenas isso para testar:

php
public function handle(Request $request)
{
$payload = $request->all();

return response()->json(['status' => 200]);
}

Nas rotas coloquei assim:

php
Route::prefix('webhook')->group(function () {
Route::get('/', [WebhookController::class, 'handle'])->name('webhook.handle');
Route::post('/', [WebhookController::class, 'handle'])->name('webhook.handle');
Route::put('/', [WebhookController::class, 'handle'])->name('webhook.handle');
});

rubenskuhl

12/11/2023

É possível sim. O /webhook faz os mesmos testes que produção, mas se referindo à CA de homologação.
Em Laravel, erro HTTP 419 indica que você está exigindo token, quando não deveria.

vinicius_cs

12/11/2023

É possível testar Webhook em homolog?

Estou desenvolvendo em Laravel, fiz a rota com o /webhook, no entanto ao executar:
https://pix-h.api.efipay.com.br/v2/webhook/:chave

É retornado:
{
"nome": "webhook_invalido",
"mensagem": "A URL informada respondeu com o código HTTP 419"
}

No WebhookController eu coloquei apenas isso para testar:

php
public function handle(Request $request)
{
$payload = $request->all();

return response()->json(['status' => 200]);
}

Nas rotas coloquei assim:

php
Route::prefix('webhook')->group(function () {
Route::get('/', [WebhookController::class, 'handle'])->name('webhook.handle');
Route::post('/', [WebhookController::class, 'handle'])->name('webhook.handle');
Route::put('/', [WebhookController::class, 'handle'])->name('webhook.handle');
});

rubenskuhl

12/11/2023

Isso. O que você pode fazer em homologação é criar cobranças de até R$10, que aí você recebe o acionamento de webhook.

peterfritz

12/11/2023

E verifica o IP e o segredo passado na sua URL do webhook antes de processar o callback!
imagem enviada na mensagem pelo usuario peterfritz

peterfritz

12/11/2023

Algo assim funcionaria:

js
import axios from "axios";
import https from "https";

const subdomain = process.env.NODE_ENV === "production" ? "pix" : "pix-h";

const clientCreds = clientId + ":" + clientSecret;
const authorization = Basic ${Buffer.from(clientCreds).toString("base64")};

const certificate = Buffer.from(certificateBase64Encoded, "base64");

const httpsAgent = new https.Agent({
pfx: certificate,
passphrase: "",
});

const oAuthResponse = await axios.post(
https://${subdomain}.api.efipay.com.br/oauth/token,
{
grant_type: "client_credentials",
},
{
headers: {
Authorization: authorization,
"Content-Type": "application/json",
},
httpsAgent,
}
);

const token = oAuthResponse.data.access_token;

const efiApi = axios.create({
baseURL: https://${subdomain}.api.efipay.com.br,
headers: {
Authorization: Bearer ${token},
"Content-Type": "application/json",
},
httpsAgent,
});

await efiApi.put(
/v2/webhook/${process.env.PIX_KEY},
{
webhookUrl:
${process.env.WEBHOOK_BASE_URL}/api/webhook/efi?secret=${process.env.WEBHOOK_SECRET}&ignore=.replace(
"//api",
"/api"
),
},
{
headers: {
"x-skip-mtls-checking": "true",
},
}
);

peterfritz

12/11/2023

Fala @blini_10032, tem sim, uso serverless e edge para receber os callbacks, então pra mim também não foi possível usar mTLS. Mas a Efí suporta um cabeçado x-skip-mtls-checking na criação do webhook que, se tiver como valor true, irá pular a validação do mTLS.
https://dev.efipay.com.br/docs/api-pix/webhooks/#:~:text=Certbot%20por%20exemplo.-,Skip%2DmTLS,-Para%20hospedagem%20em>">Documentação do Skip-mTLS.

> Só lembre-se de verificar se o IP que envia a requisição https://sejaefi.com.br/central-de-ajuda/api/quais-enderecos-de-ip-gerencianet-utiliza#conteudo>">pertence à Efí e enviar um segredo conhecido apenas pelo seu servidor na URL quando criar o seu webhook como recomendado na documentação.

rubenskuhl

11/11/2023

Sim, faz. Segue o texto do autor do pix.ae:

Pra quem tem dificuldades de implementar os webhooks por falta de suporte em hospedagem compartilhada para configurar mTLS, o Pix.ae agora oferece proxy de callbacks com mTLS.

Pra usar é muito simples: é só prefixar o seu domínio com mtls.pix.ae/. Por exemplo:

Para: https://exemplo.com.br/webhookpix
Use: https://mtls.pix.ae/exemplo.com.br/webhookpix

Obs: no ambiente de homologação, prefixe com mtls-h.pix.ae/

blini_10032

11/11/2023

"..fazer apenas essa parte nessas soluções, não precisa portar tudo pra AWS/OCI."
sim @rubenskuhl eu só preciso de um lugar pra processar o webhook, o resto tá td pronto, só falta isso pra eu lançar

blini_10032

11/11/2023

tem algum jeito de usar o webhook sem certificado?

rubenskuhl

11/11/2023

O pix.chaves.{chave}.webhook.notificacao.pagador precisa ser true.

rubenskuhl

11/11/2023

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

peterfritz

Oi, boa tarde. Vocês sabem se existe algum jeito de consultar o pagador de um QR Code ou BR Code que foi cadastrado sem informar um devedor?
Na secção de https://dev.efipay.com.br/docs/api-pix/webhooks#requisi%C3%A7%C3%A3o>">requisição (callback) da documentação de webhooks, vi que é possível que os dados do pagador sejam recebidos no callback através da propriedade gnExtras.pagador, porém o objeto gnExtras é opcional e, até então, só tenho recebido através de callbacks os seguintes dados:

json
{
"pix": [
{
"endToEndId": "...",
"txid": "...",
"chave": "...",
"valor": "...",
"horario": "..."
}
]
}

No extrato é possível visualizar pagador, documento e instituição, então imagino que há alguma forma de solicitar esses dados através da API.
Agradeço desde já e peço perdão pela mensagem longa.

rubenskuhl

11/11/2023

Tem que configurar para recebedor o pagador no webhook. Mas além do webhook, ele fica disponível também no extrato de conciliação.

E não é pq tem algo no app que tenha na API... o BACEN tem restrições específicas para API devido a possível processamento em massa de dados pessoais.

Histórico de mensagens sobre webhook em pix

CONECTAR AO DISCORD

PROCURE NO HISTÓRICO

CANAIS DE TEXTO

DISCUSSÕES

EXIBINDO CONVERSAS RECENTES:

joaolucas_efi

allanmello

_ganimedes

rubenskuhl

vinicius_cs

rubenskuhl

rubenskuhl

vinicius_cs

rubenskuhl

vinicius_cs

rubenskuhl

peterfritz

peterfritz

peterfritz

rubenskuhl

blini_10032

blini_10032

rubenskuhl

rubenskuhl

rubenskuhl