Histórico de mensagens sobre webhook pix

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"
}

Resolvi um problema, mas me deparei com outro.

Não é enviado webhook para mim quando o pix fica expirado ?

Por exemplo, eu coloquei os pix para expirarem em 10min se a pessoa não pagar quero remover a reserva da minha base de dados, mas se não me retornam por webhook essas coisas, vou ter que rodar cron jobs para ficar direto checando por requisição, não achei nada sobre isso na parte de webhook, apenas as respostas para pagamento concluído, que no caso já está funcionando em meu sistema, ficou pendente apenas essa parte de resposta para caso de não pagamento

Boa tarde, uma dúvida sobre a configuração de conta, mas especificamente a parte do recebimento: {recusarTipoPessoa: "PJ"} , como fica o fluxo nesse caso? Se alguém tentar pagar por uma conta PJ não vai conseguir? Ou vai conseguir, mas será estornado logo em seguida? E nesse caso, vai ter algum tipo de webhook identificando que um CNPJ pagou/tentou pagar aquele pix?

Bom dia, @christopy! Tudo bem?
Não. Se o Pix expirou, não é disparado um webhook, pois o status do Pix não é alterado, ele permanece com o status "ATIVO". Como o Pix ainda está "ATIVO", você pode usar o endpoint PATCH /v2/cob/:txid para alterar o tempo de expiração e permitir o pagamento novamente.

Uma maneira de verificar se o Pix expirou é comparar a __data e hora atual__ com a __data e hora de emissão + o tempo de expiração em segundos__ definido ao criar a cobrança. Se a data e hora atual for maior que a data e hora de expiração, significa que o Pix não pode mais ser pago. Caso contrário, o Pix ainda está ativo e pode ser pago normalmente.

Olá, quando faço o registro do webhook usando skip-mtls em produção via postman um teste é feito na minha API e da tudo certo, porém quando faço um pix de 0,01 o webhook não é disparado.
Alguém tem alguma dica do que pode ser?
pesquisei em nas conversas aqui, encontrei casos parecidos, mas não encontrei a solução

Boa tarde, em minha api swagger eu criei o endpoint verbo post na rota /api/webhook/pix
estou usando nginx com a location "/" que esta funcionando corretamente.
Tenho duvidas na configuração do webhook.
Poderia me ajudar?

O webhook de pix enviado, não envia o txid dentro do objeto do pix igual no recebimento? A doc não mostra esse campo em nenhum dos dois exemplos

Boa tarde! Estou com dificuldades para configurar o módulo para whmcs. consegui configurar para boleto, mas quando tento configurar o PIX dá um erro: "Falha ao cadastrar webhook: Error : Access token has insufficient scope Suas alterações não foram salvas."

Obs.: Já havia configurado há 3 dias atrás e funcionou, porém parou de funcionar.. na tentativa de fazer funcionar eu acabei baixando a nova versão do módulo ontem, portanto o mesmo já se encontra atualizado.

Versão do whmcs: 8.11.0
PHP: 8.1
Certificados do PIX configurados em uma pasta na raiz.

Você pode começar usando este recurso provido por um dev:

Lembrando que o webhook é o que avisa o seu back-end de que o Pix foi pago... você vai precisar de algo que leve essa informação do back-end para o front-end. Por exemplo, um WebSocket. Uma sugestão é fazer o QR-Code sumir assim que for pago.

Neste caso recomendo implementar um webhook, que é a notificação de pagamentos Pix. Desta forma, assim que o Pix for confirmado, em questão de segundos, o seu sistema receberá um webhook, com as informações de pagamento, o txid da cobrança e demais dados...

No caso @logaaaa, seria necessário desenvolver algo que atualizasse a tela após o recebimento do webhook de pagamento deste Pix

Bom dia, @tanzin7! Tudo bem?

Sim, você pode ativar o recebimento do nome e CPF mascarado do pagador. Para isso, basta usar o endpoint PUT /v2/gn/config (Criar/modificar configurações da conta) e incluir o atributo recebimento>webhook>notificacao>pagador: true.

Com essa configuração ativa, o seu sistema vai receber uma notificação parecida com esta:

Estou tentando utilizar o ambiente de produção e queria primeiramente configurar o webhook do pix.

Porém estou recebendo esse erro aqui:

@he128 o webhook é cadastrado na sua chave Pix, apenas 1 vez, por meio deste endpoint: https://dev.efipay.com.br/docs/api-pix/webhooks#configurar-o-webhook-pix

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 ?

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 ?

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 ?

Bom dia, @christopy ! Tudo bem?

Sim, é possível receber esses Webhooks. No entanto, você precisa alterar as configurações da conta através deste endpoint para que isso aconteça. Nele, há a opção webhook.notificar.pixSemTxid. Ao configurá-la como true, começaremos a enviar os webhooks para essas transferências.

Bom dia, @oziellcarvallho. Tudo bem?
Para testes você pode utilizar o header x-skip-mtls-checking como true, mas recomendamos que você verifique a possibilidade de implementar uma segurança mTLS na comunicação entre seu webhook e o nosso servidor, para obter mais detalhes sobre o mTLS e o skip-mTLS sugerimos que dê uma olhada nestes dois trechos de nossa documentação: https://dev.efipay.com.br/docs/api-pix/webhooks#entendendo-o-padr%C3%A3o-mtls e https://dev.efipay.com.br/docs/api-pix/webhooks#exemplos-de-configura%C3%A7%C3%B5es-de-servidor