HomeGuiaAPI ReferenceNovidadesComunidade
Comunidade
These docs are for v1.0. Click to read the latest docs for v4.1.

Comunidade

Ask a Question
Back to all

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:

  1. 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?

  2. 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?

  3. Caso a preferência não contemple vendas presenciais, existe alguma outra API ou configuração para cadastrar um webhook global para as maquininhas?

  4. Quando uma venda é realizada na maquininha, o PagBank disponibiliza os itens vendidos na notificação? Caso disponibilize, quais informações são enviadas?

  5. 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?

  6. 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!

© 1996- Todos os direitos reservados.

PAGSEGURO INTERNET INSTITUIÇÃO DE PAGAMENTO S/A - CNPJ/MF 08.561.701/0001-01

Av. Brigadeiro Faria Lima, 1.384, São Paulo - SP - CEP 01451-001