Comunidade
Dúvidas sobre webhooks, Preferências de Notificação e recebimento de vendas realizadas nas maquininhas PagBank (pelo PagVendas)
Olá, equipe PagBank!
Estou desenvolvendo uma integração entre o PagBank e meu sistema e gostaria de esclarecer algumas dúvidas sobre o funcionamento dos webhooks, principalmente para vendas realizadas presencialmente pelas maquininhas PagBank.
1. Meu objetivo
Preciso que meu sistema receba automaticamente uma notificação sempre que uma venda for realizada em uma maquininha PagBank, para que eu possa identificar a venda e registrar as informações correspondentes no meu sistema.
Além de saber que uma venda foi aprovada, preciso entender se é possível receber informações detalhadas sobre os itens vendidos, como nome do produto, quantidade e valor.
As vendas são realizadas diretamente pelos operadores nas maquininhas, e não são criadas pelo meu sistema através da API.
2. Testes realizados
Já realizei alguns testes utilizando o ambiente Sandbox:
- Criei uma chave pública do tipo webhook.
- Cadastrei uma Preferência de Notificação através do endpoint /notifications/preferences, utilizando o evento ORDER.CHARGE e a URL do meu webhook como destino.
- Criei uma Order pela API, sem informar notification_urls, e realizei o pagamento via Pix.
- Mesmo com a preferência cadastrada, não recebi nenhuma notificação no meu servidor.
- Posteriormente, criei outra Order informando notification_urls diretamente no payload. Nesse caso, a notificação foi recebida normalmente pelo meu servidor.
Isso demonstra que meu endpoint está funcionando, mas não consegui confirmar se a Preferência de Notificação funciona independentemente do campo notification_urls.
3. Dúvidas sobre o funcionamento
Gostaria de esclarecer os seguintes pontos:
-
A API de Preferências de Notificação (/notifications/preferences), utilizando o evento ORDER.CHARGE, funciona para receber notificações de vendas realizadas diretamente nas maquininhas PagBank?
-
Essa preferência permite cadastrar uma URL uma única vez para receber automaticamente as notificações de todas as vendas da conta, sem precisar informar notification_urls individualmente em cada pedido?
-
Caso a preferência não contemple vendas presenciais, existe alguma outra API ou configuração para cadastrar um webhook global para as maquininhas?
-
Quando uma venda é realizada na maquininha, o PagBank disponibiliza os itens vendidos na notificação? Caso disponibilize, quais informações são enviadas?
-
Existe alguma maneira de identificar, por meio da notificação ou de uma consulta posterior à API, os produtos, quantidades e valores que compõem uma venda realizada na maquininha?
-
Como posso realizar um teste confiável no Sandbox para simular uma venda originada em uma maquininha e confirmar que a notificação será enviada corretamente?
4. Necessidade de confirmação
Essa funcionalidade é essencial para a viabilidade da integração que estou desenvolvendo.
Não é viável informar manualmente notification_urls em cada venda, pois os pedidos são realizados diretamente pelos operadores nas maquininhas, sem passar pelo meu sistema.
Preciso saber se existe uma maneira oficialmente suportada pelo PagBank de receber essas notificações automaticamente e, principalmente, se os dados dos produtos vendidos estarão disponíveis.
Se possível, gostaria de receber uma orientação técnica com os endpoints, eventos e configurações necessários para implementar essa integração corretamente.
Agradeço desde já pela atenção!
