Histórico de mensagens sobre webhook pix

EXIBINDO CONVERSAS RECENTES:

Texto: webhook pix
# pix
Avatar discord do usuario anoni_mato

anoni_mato

Ver Respostas

Não entendi esta:

Integrador cadastrou a url base https://gerencianet.com.br/?id=0000x22, ao acionar o webhook uma requisição do tipo POST será enviada para https://gerencianet.com.br/pix?id=0000x22

A possibilidade mais simples de contornar a concatenação do /pix que a documentação força é justamente colocar um ?x= ao fim da URL para ficar ?x=/pix.

então pergunto:

1. qual a razão para agregar o /pix "no meio" da URL que foi definida pelo integrador e não no fim?
2. isso vai contra a documentação atual que diz que o /pix irá (sempre) no fim da URL - e se for pra mudar o conceito, seria melhor que esse /pix fosse retirado.

e sugiro aos integradores que estão lendo agora: não usem query params na URL do webhook conforme esse exemplo (prefiram path params)

# sugestões
Avatar discord do usuario francisco.carvalho

francisco.carvalho

Ver Respostas

## Objetivo

Permitir que o EC defina algumas configurações:

- Quando aceitar um txid;
- Aceitar ou não Pix Manual;
- Quais notificações receber via webhooks;
- Receber ou não a tarifa no webhook;
- Outras configurações podem surgir.

---

# PUT /gn/config

## Input

json
{
"pix": {
"aceitarSemChave": true,
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}, {
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": false,
"recusa": false
}
}
}]
}
}

## Output: 200

---

## Definições

Por default:
→ Todas as notificações nascem habilitadas;
→ Não há match de regex: aceita-se qualquer txid;
→ Tarifa não é retornada no webhook;
→ Pix Manual é acatado sempre;

Default em JSON

json

{
"pix": {
"aceitarSemChave": true,
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "" // se vazio, desconsiderar
}
}]
}

# pix
Avatar discord do usuario francisco.carvalho

francisco.carvalho

Ver Respostas

No endpoint POST /pix caso a chave do recebedor não exista, você receberá um erro na hora. Isso significa que o webhook nem será acionado pois a solicitação de envio de Pix não funcionou.

Sobre os aplicativos conseguirem indicar contatos cujo telefone/email já estejam cadastrados no Pix, sabemos que estuda-se isso no BC e inclusive nós enviamos há pouco tempo uma proposta relacionada.

Pode ser que em breve seja viável uma "consulta no cache do DICT", de forma que não se gaste as fichas do bucket oficial...

# pix
Avatar discord do usuario joelemanoel

joelemanoel

Ver Respostas

A ideia é conseguir validar a chave antes de enviar o Pix e informar que essa chave não existe para fazer o Pix, por exemplo, sem a necessidade de esperar o webhook ou o processamento da solicitação de envio do Pix.

# sugestões
Avatar discord do usuario francisco.carvalho

francisco.carvalho

Ver Respostas

{
"pix": {
"recebimentoManual": "aceitar",
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "^[a-zA-Z0-9]+$"
}
}, {
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": false,
"recusa": false
}
}
}]
}
}

Definições:

Por default:
- Todas as notificações nascem habilitadas;
- Não há match de regex: aceita-se qualquer txid;
- Tarifa não é retornada;
- Pix Manual é acatado sempre;

Default em JSON

{
"pix": {
"recebimentoManual": "aceitar",
"chaves": [{
"valor": "[email protected]",
"webhook": {
"notificar": {
"envio": true,
"recebimento": true,
"devolucao": true,
"recusa": true
},
"incluir": {
"tarifa": true
}
},
"recebimento": {
"txidRegex": "" // se vazio, desconsiderar
}
}]
}

Observação
Quando de um envio de Pix: a notificação de webhook, em caso de status NAO_REALIZADO , poderá trazer o motivo da falha (PSP deu timeout, recusou, etc..). Em outro momento falaremos disso.

# pix
Avatar discord do usuario jessica_efi

jessica_efi

<@!664563985885954079>, o e2eid você consegue somente depois de pagar o Pix.. Então você pegar ele através do webhook que você recebe ou consultando Pix recebidos

# sugestões
Avatar discord do usuario francisco.carvalho

francisco.carvalho

Ver Respostas

<@!522899003663450113> acredito que podemos assumir que, se webhook.notificar.envio for habilitado, a notificação do envio de Pix será enviada com a informação se foi sucesso ou falha. Em caso de falha, irá constar o motivo, que pode ser uma recusa ou timeout do PSP recebedor.

# pix
Avatar discord do usuario anoni_mato

anoni_mato

o próprio BACEN que retirou da spec argumentando que um Pix (e2eid) só chega ao cliente quando já está concluído, então você deve se basear na existência ou não de items de devolução dentro do pix pra saber quanto recebeu referente ao e2eid [e quanto foi devolvido, se for o caso] e não num campo de "status", pois um webhook pode ser acionado no momento que uma devolução acontecer, por exemplo e aí o status fica meio dúbio.. deveria ser, ainda, recebimento/recebido (pq o Pix foi recebido) ou devolução/devolvido por ser uma notificação acionada pelo gatilho de devolução? se o Pix for R$ 100 e a devolução for parcial, de R$ 10, fica ainda mais complicado se basear só nesse campo.

# sugestões
Avatar discord do usuario francisco.carvalho

francisco.carvalho

Ver Respostas

Pessoal, gostaria de opiniões e sugestões em cima desse desenho de endpoint:

PUT /config

Objetivo: permitir que o integrador controle alguns comportamentos. Por hora: receber ou não webhooks, receber ou não a tarifa cobrada como atributo na notificação do webhook, setar uma regex que será considerada na validação do txid.

{
"pix": {
"webhooks": {
"notificar": {
"envio": true,
"recebimento": true,
"recusa": true
}
},

"tarifas": {
"informar-no-webhook": true
},

"pagamentos": {
"validar-txid-regexp": "^[a-zA-Z0-9]+$"
}
}
}

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Boa tarde! Você pode consultar o Pix /v2/pix/:e2eId que vai ser retornado um array contendo todas as devoluções, como este:

{
"endToEndId": "E18236120202012211356s0848037HBE",
"txid": "fc9a2223k6ff39i84ryP5ff4ga9719",
"valor": "0.03",
"horario": "2020-12-21T13:56:48.000Z",
"devolucoes": [
{
"id": "fc9a2223k6ff39i84ryP5ff4ga9719",
"rtrId": "D090893562020189898357ca70d788c78",
"valor": "0.01",
"horario": {
"solicitacao": "2020-12-21T13:57:12.000Z",
"liquidacao": "2020-12-21T13:57:14.000Z"
},
"status": "DEVOLVIDO"
},
{
"id": "fc9a2223k6ff39i84ryP5ff49a971",
"rtrId": "D09089356202012211357875bec9c899",
"valor": "0.02",
"horario": {
"solicitacao": "2020-12-21T13:57:36.000Z",
"liquidacao": "2020-12-21T13:57:38.000Z"
},
"status": "DEVOLVIDO"
}
]
}
Ou por meio do webhook que também tem as informações da devolução. Outra forma é pelo /v2/pix/:e2eId/devolucao/:id que retorna os detalhes da cada devolução.

# pix
Avatar discord do usuario guilherme_efi

guilherme_efi

Isso mesmo, Renato. <@!585695073908293632>, pode ter sim SSL Lets Encrypt.

Neste caso, para que funcione em sua URL, você deve especificar a rota para exigir o certificado somente na rota /webhook. Da forma que está utilizando, irá exigir certificado a qualquer rota da sua URL

Para isso, para configurar utilize:

SSLCertificateFile /caminho_certificado/server_ssl.crt.pem
SSLCertificateKeyFile /caminho_certificado/server_ssl.key.pem

SSLCACertificateFile /caminho_certificado/chain-pix-prod.crt

SSLVerifyClient none

SSLVerifyClient require
SSLVerifyDepth 3

# pix
Avatar discord do usuario marcosvinicius1489

marcosvinicius1489

Ver Respostas

A gerencia net tem webhook para o pix ?

# pix
Avatar discord do usuario .jaquelinesantos

.jaquelinesantos

Ver Respostas

Renato, agradecemos suas observações e elas serão consideradas...

Mas esclarecendo os pontos, quando você gera o estático, não consome a API, portanto não gera custo. O que gera o custo, é a utilização do webhook, no estático, utilizamos a webhook para o recebimento, porém, como você mesmo pontuou, esta é uma questão que está sendo verificada.

Mas neste momento não é uma preocupação, visto que temos a tarifa zerada até abril de 2021.
No link enviado a informação é que "As transações originadas pela API Pix serão gratuitas até o dia 30/04/2021."

Apenas corrigindo a minha mensagem, é "Pix recebido com valor IGUAL ou superior a R$90,00 = R$0,89" conforme link:

https://gerencianet.com.br/tarifas/

# pix
Avatar discord do usuario rubenskuhl

rubenskuhl

Ver Respostas

De na hora de ativar o webhook, eles tentarem com /pix?client_id=xxxxx, e fazerem fall-back para o anterior sem /pix se não der certo. Assim eles não precisam fazer uma virada de chave combinada, as pessoas vão migrando.

# pix
Avatar discord do usuario matheus_efi

matheus_efi

Ver Respostas

Como citado pelo Rubens, o webhook só é acionado se houver um txid associado ao Pix. No momento as notificações estão ocorrendo somente no Pix dinâmico, mas já estamos trabalhando para ofertar em Pix estático com txid vinculado.

# mercado-pagamentos
Avatar discord do usuario anoni_mato

anoni_mato

Ver Respostas

mas no relatório tem o ID que eles chamam de "Operação". e eles tb notificam via webhook as "operações" pagas via Pix. o que mais vc precisa no relatório? 🤔

# pix
Avatar discord do usuario rafael_fig

rafael_fig

Ver Respostas

Boa tarde, estou fazendo a questão do webhook, fiquei com algumas dúvidas, o parâmetro "chave" diz respeito a chave pix mesmo ou é o txid?

# pix
Avatar discord do usuario anoni_mato

anoni_mato

Ver Respostas

<@!775350441965649951> , desculpa me intrometer, mas você falou algumas coisas erradas.

1. o GET /pix?txid=xxx é para consultar Pix recebidos (indiferente serem oriundos de QR estático ou dinâmico, tendo txid eles retornam nessa consulta), e não cobranças (que é no GET /cob)

2. pra consultar o(s) Pix recebido(s) por QR estático com um determinado txid ficaria GET /pix?txid=xxx&inicio=data_inicio&fim=data_fim

3. tendo o e2eid (que vem no retorno da consulta acima ou pelo webhook - quando a GN estiver notificando recebimentos oriundos de QR estático), aí pode-se consultar GET /pix/{e2eid}

# pix
Avatar discord do usuario anoni_mato

anoni_mato

e se quiser mais detalhes, depois que já tiver o e2eid (obtido nessa consulta acima, ou por webhook, quando a GN passar a notificar pagamentos via qr estáticos), poderá usar o GET /pix/{e2eid}