Histórico de mensagens sobre webhook

E tem prazo para essa mudança? Se o problema do webhook não é esse, como descubro o motivo de não estar recebendo o webhook?

Bom dia! Fiz uma pesquisa no site, superficial, e não encontrei a informação de que é necessário mudar do SDK gn-api-sdk-node para o SDK sdk-node-apis-efi. Meu webhook parou de funcionar. Será esse o motivo?

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!

Bom dia, estou com uma dúvida quanto a funcionalidade da API do PIX, li a documentação mas não consegui uma resposta.

É possível gerar um qrcode estático para receber diversos pagamentos sem data de expiração? A ideia do cliente é imprimir esse QR code para deixar na máquina dele, quando o cliente paga (sem fornecer dados) recebemos um webhook para a máquina realizar uma ação.

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

Boa tarde!!
A API de PIX envia uma notificação para a webhook de quando a cobrança expira ou por exemplo quando é pago. Dentro do Efi consigo ver quando foi disparada essa requisição ao meu webhook e seu retorno?

Não há outras mudanças assíncronas de status para o webhook reportar... as outras possíveis mudanças são quando você muda a cobrança via comando PATCH, mas aí o resultado já vem na resposta do comando.

Se veio um webhook com objeto Pix, foi pago e o status é CONCLUIDO.

se puder me tirar uma duvida dos callbacks dos webhooks da api pix, estou dando uma lida na documentação e não encontro onde ele retorna o status do pix, não vejo os status das alterações.

Bom dia, @kvtwetfps! Como vai?
Como o Rubens mencionou, você pode usar o endpoint https://dev.efipay.com.br/docs/api-pix/endpoints-exclusivos-efi#criarmodificar-configurações-da-conta">PUT /v2/gn/config para habilitar a configuração webhook.notificacao.pagador=true que permite receber no webhook o nome e o CPF mascarado do pagador, conforme exemplo abaixo:

Se você habilitar a configuração de receber dados do pagador, vem no webhook.
{
"pix": {
"receberSemChave": true,
"chaves": {
"355e4568-e89b-1243-a456-006655440001": {
"recebimento": {
"txidObrigatorio": false,
"recusarTipoPessoa": "PF",
"qrCodeEstatico": {
"recusarTodos": false
},
"webhook": {
"notificacao": {
"tarifa": true,
"pagador": true
},
"notificar": {
"pixSemTxid": true
}
}
},
"envio": {
"webhook": {
"notificacao": {
"tarifa": true,
"favorecido": true
}
}
}
}
}
}
}

Olá, pessoal! Por gentileza, iniciante aqui. Estou tentando fazer meu webhook (uso spring jdk 21). Minha aplicação está dockerizada e rodando com SSL. Porém estou com dificuldades para preparar o ambiente para o certificado da Efi. Preciso de um norte... meu SSL não está rodando no nginx

Eu ja tinha tentado fazer dessa forma e adicionando na query da url... Sendo que percebi agora que estava adicionando esses parametros no do endpoint do put do efi, e nao no campo do body "webhookUrl". Adicionando no lugar certo aqui, eu consigo receber esses parametros lá na minha API e fazer a orquestração

Multi-tenancy não é problema pro mTLS, pq as chamadas para todos os clientes Efí usam a mesma CA (CA privada da Efí) e mesmo CN (gn-webhook-pix), etão você pode usar a mesma configuração para todos.

No webhook vem a chave Pix, e cada chave Pix é de um client... então você já tem uma informação para diferenciar os tenants, e pode usar até mesmo a exata mesma URL para tudo. Agora, dá para adicionar um parâmetro do webhook que vc configura em cada chave Pix para ter um double check. Poderia ser por exemplo:
"https://webhookefi.zonkof.com.br/?tenant-id=xxxxxx&ignorar="

O ignorar= é pq a Efí vai adicionar um /pix no final.

Galera, minha API utiliza uma abordagem multi-tenancy, ou seja, é uma unica API que atende a vários bancos de dados, cada banco de dados (Entenda cada banco de dados, como uma empresa que contrata o meu sistema.)
Estou utilizando o cloud run do GCP para hospedar a API, e quero configurar o webhook de pix, porém vi que precisa adicionar uns certificados na configuração do nginx/apach/express etc.. e tem que fazer algo relacionado aos certificados ssl da API e tal.. porém, como está no gcp, isso ficaria dificil. Entao gostaria de utilizar a abordage do Skip-mTLS...

Como mencionei acima, minha aplicação é multi-tenancy, e existe um middleware na minha API que recebe na requisição um parametro chamado "x-tenant-id" (atualmente é um header, mas pode ser qualquer coisa que funcione kk). Então gostaria de saber como eu poderia proceder para que em todas as requisições do webhook que a EFI mandará para a minha API, tenha algum identificador para que possa fazer a orquestração de qual banco de dados realizarei as consultas aqui.. Poderiam me ajudar com isso?

No Efí, @EneasRocha, oferecemos serviços de banco e de meios de pagamento para empresas bem como também para empreendedores e microempreendedores que ainda não possuem CNPJ, que seria a modalidade de conta Pró. Nesse sentido, pensando em pequenos negócios é que existe a interface manual direta pela plataforma para que este público possa oferecer meios de pagamento dos seus serviços/produtos sem a necessidade de um sistema integrador.

No entanto, no que tange os boletos bancários, essas soluções não se comunicam entre si, integração é um ecossistema e o controle via conta digital é outro. Já para o PIX é possível configurar um webhook vinculado a uma chave da conta e todas as cobranças vinculadas a essa chave serão notificadas.

Se o seu caso for exclusivamente de boletos/carnês, Eneas, temos algumas sugestões:
Migração orgânica, onde não se emite mais diretamente pela conta e passa a emitir somente via API, mas mantendo o controle pelas duas pontas até que não haja mais cobranças ativas que foram emitidas diretamente pela conta digital (via Sistema);
Gerar um relatório das cobranças geradas via Sistema, importar para a sua integração para reemití-las via API e então excluir as cobranças antigas.

Só queria ativar a opção recebimento.webhook.notificar.pixSemTxid, não tem uma opção pra isso fora da API, direto na conta/web?

Poderia por favor me indicar exatamente qual é a opção que preciso marcar para ter acesso ao escopo gn.settings.write a fim de conseguir configurar a opção recebimento.webhook.notificar.pixSemTxid ? Estou na tentativa e erro aqui há muito tempo! Grato.

Olá! Estou testando o sistema de assinaturas no ambiente de homologação e percebi que, ao criar uma assinatura, recebo o notification_token no webhook corretamente. Consigo consultar as informações e o status da assinatura através do endpoint de GET. No entanto, o status da cobrança parece permanecer como "waiting" e não evolui, o que dificulta validar o funcionamento completo do meu fluxo de pagamentos.

Minha dúvida é:

No ambiente de homologação, o status das cobranças muda automaticamente, ou é necessário realizar alguma ação manual para simular a mudança de status (como pagar a cobrança)?
Existe algum processo ou endpoint específico para simular essas alterações no ambiente de teste?
Obrigado!

Olá, @gabrielkaka123. Bom dia! Tudo bem e com você?

A forma ideal de verificar os pagamentos de cobranças Pix é usando um webhook. Para isso, você configura através do endpoint PUT /v2/webhook/:chave, uma URL do seu site associada à chave Pix usada nas cobranças. Assim, quando uma cobrança for paga, a API do Efí envia automaticamente uma notificação para sua URL com um JSON contendo as informações do Pix.

Entre essas informações estará o txid (identificador do Pix que você emitiu). Com isso, você poderá fazer a conciliação e realizar processos como o envio do e-mail que deseja.

Se tiver qualquer outra dúvida, conte com a gente!