Histórico de mensagens sobre webhook

Bom dia, @sheikzadarevo! Tudo bem?
A URL de notificação não é definida na emissão da cobrança Pix.

Você deve associar uma URL de notificação a sua chave Pix, então as cobranças Pix que tiverem um txid e sua chave Pix, nós iremos enviar a notificação para a URL registrada. Essa configuração pode ser feita uma única vez através do endpoint PUT/v2/webhook/:chave (https://dev.gerencianet.com.br/docs/api-pix-endpoints#configurar-o-webhook-pix).

Pontuando que para registrar sua URL de notificação, seu servidor deve possuir algumas configurações para atender a comunicalção com mTLS. Você encotra mais detalhes em nossa documentação: https://dev.gerencianet.com.br/docs/api-pix-endpoints#webhooks

Sim, o webhook é melhor, porém não é muito elegante fazer if() para saber se é uma devolução, se é um pagamento, se é um envio de pix. Eu mesmo ainda não finalizei essa parte por conta desse retorno que não retorna tipo nem status....os GET's seriam uma melhor solução para mim. Mas preciso usar os webhooks.

Não necessariamente. Há 3 maneiras de confirmar um pagamento:
GET em /pix filtrado pelo txid
GET em /cob, ver se tem objeto pix
Objeto pix enviado pelo webhook

O webhook é o que dá melhor experiência e escalabilidade, mas é bom ter um dos outros dois como fall-back.

Olá @alexsandersouza ! Agradecemos pela observação. A equipe responsável já está providenciando a atualização na documentação. Editei a mensagem que havia te enviado anteriormente. Você pode baixar a chave pública em produção por este link: https://pix.sejaefi.com.br/webhooks/chain-prod.crt

Pessoal uma dúvida. No callback das cobranças eu não recebo o status. Isso quer dizer que toda vez que eu receber um callback de uma determinada cobranca pix eu tenho que fazer uma consulta no endpoint de cobrança para saber o status do pagamento? Ou ele retorna isso de alguma forma no webhook e eu que não estou sabendo utilizar? Lembrando que não estou usando SDK criei toda estrutura php para o meu caso.

O de produção é o https://pix.sejaefi.com.br/webhooks/chain-prod.crt

joia, tentarei
o de produção continua o https://pix.gerencianet.com.br/webhooks/chain-pix-prod.crt ?

O crt da Efí foi alterado para: https://pix.sejaefi.com.br/webhooks/chain-sandbox.crt

Segue todos os escopos da API PIx:

Alterar Cobrança = cob.write
Consultar Cobrança = cob.read
Alterar Cobrança com Vencimento = cobv.write
Consultar Cobrança com Vencimento = cobv.read
Alterar Payload = payloadlocation.write
Consultar Payload = payloadlocation.read
Alterar Pix = pix.write
Consultar Pix = pix.read
Alterar Webhook = webhook.write
Consultar Webhook = webhook.read
Consultar Saldo da Conta = gn.balance.read
Alterar Chave Aleatória = gn.pix.evp.write
Consultar Chave Aleatória = gn.pix.evp.read
Alterar Configurações da API = gn.settings.write
Consultar Configurações da API = gn.settings.read
Solicitar relatórios = gn.reports.write
Consultar relatórios = gn.reports.read

A API de emissões é ativada por padrão, então neste caso, você não precisa de passar nenhuma informação para que o cliente emita cobranças cartão, boletos, carnês...

Em relação ao Boleto sem Pix = O cliente tem que deixar desativado o Bolix dentro da conta Digital

Boa tarde

Este endpoint

/cadastro/conta-simplificada/:identificador/credenciais

Retorna as informações para produção, correto ?

Tem os escopos integrados

Enum:
cob.write, payloadlocation.write, payloadlocation.read,

cob.read, pix.write, pix.read, pix.send, webhook.write, webhook.read,

gn.pix.send.read, gn.balance.read, gn.pix.evp.write, gn.pix.evp.read, gn.settings.write,

gn.settings.read, gn.barcode.read, gn.barcode.pay.write,gn.barcode.pay.read

Aonde vejo o significado de cada um ?

Posso alterar após o cadastro ?

Boa tarde pessoal, alguém conseguiu usar o nginx para validar o certificado do cliente da efí no webhook?
eu configurei e testei com outro certificado de cliente e deu tudo certo mas com o da efi da falha

eu obtive o mesmo erro no outro certificado quando não tinha todas as cadeias presentes no arquivo, mas assim que adicionei funcionou, sabem se esse da efí está faltando mais cadeias intermediarias ou a root?

Eu sei que o nginx não consegue validar caso esteja faltando alguma cadeia.
erro informado pelo nginx: FAILED:unable to verify the first certificate

crt usado da efí: https://pix.gerencianet.com.br/webhooks/chain-pix-sandbox.crt

Boa tarde, estou tentando cadastrar um novo pix webhook passando no header o atributo x-skip-mtls-checking como true e mesmo assim estou recebendo o erro UNABLE_TO_VERIFY_LEAF_SIGNATURE. Mesmo informando a esse skip no header a efi vai tentar validar o endpoint cadastrado?

/webhook

Boa tarde @israelcosta ! Se fosse alguma falha no certificado, você não conseguiria cadastrar o webhook. Vou iniciar um atendimento privado pra pegar masi detalhes.

Sim, acabei de fazer isso:


{
"parametros": {
"inicio": "2023-05-22T16:01:35.000Z",
"fim": "2023-06-23T16:01:35.000Z",
"paginacao": {
"paginaAtual": 0,
"itensPorPagina": 100,
"quantidadeDePaginas": 1,
"quantidadeTotalDeItens": 1
}
},
"webhooks": [
{
"webhookUrl": "/webhook",
"chave": "-e585-48ff-86ac-",
"criacao": "2023-06-10T14:29:18.000Z"
}
]
}

Bom dia @israelcosta ! Tudo bem? Quando você consulta os webhooks cadastrados para a chave, este é listado?

Eu mudei o status de waiting para settled, queria pegar essa mudança no webhook para atualizar no BD

A cobrança é de um valor que gera pagamento ? Em homologação é o valor que determina se o webhook será acionado.

Tem algum lugar que da para verificar para qual caminho está sendo enviado o webhook do boleto?

Listei os webhook cadastrado está certo