Webhook

O webhook é o canal de notificações de venda do PINPDV. Em vez de o seu sistema ficar consultando o status (polling), é o PINPDV que avisa o seu sistema sempre que algo muda em uma venda.

A cada alteração em uma venda — criação, atualização de status e conclusão — o PINPDV envia um POST para a URL que você cadastrou. Vale para todos os módulos que geram vendas: TEF Mobile, Pré-venda, Venda Expressa e Venda Avulsa.

Como cadastrar a URL do webhook#

O cadastro é feito no Portal do Cliente PINPDV, em três passos. Clique nas imagens para abri-las em tamanho real.

1. Abra o menu do usuário. No canto superior direito do portal, clique sobre o nome do usuário logado.

2. Selecione “Configurações”. No menu que se abre, clique em Configurações.

3. Informe a URL em “Webhook”. Na aba Configurações do Portal → Configuração, o primeiro bloco da página é o Webhook. Preencha o campo com o endereço que vai receber as notificações (protocolo https://) e salve.

A partir do salvamento, toda alteração de venda passa a ser notificada nessa URL. Para desativar o webhook, basta apagar o endereço e salvar.

Acompanhando as notificações#

Os envios podem ser acompanhados no Portal do Cliente PINPDV, em Configurações → Inspeção Técnica → Notificações de Venda. Use essa tela para auditar o que foi disparado e diagnosticar falhas de entrega.

Valor enviado pelo PINPDV#

A cada alteração na venda, o PINPDV envia um POST para a sua URL com o corpo em JSON. Use o campo status para identificar o momento relevante para o seu fluxo (ex.: agir apenas quando status.value = "Realizada").

POST {sua-url-de-webhook}
Content-Type: application/json

{
  "id": 288581,
  "identificador": "pedido-001",
  "tipoVenda": { "key": 1, "value": "Expressa" },
  "valor": 100.11,
  "isDocumento": false,
  "cadastradoEm": "2026-04-30T14:59:58.573",
  "status": { "key": 0, "value": "Realizada" },
  "transacoes": [
    {
      "id": 256657,
      "valor": 100.11,
      "parcelas": 1,
      "status": { "key": 0, "value": "Aprovada" },
      "tipoPagamento": 3,
      "pagamentoTipo": { "key": 3, "value": "Debito" },
      "dados": {
        "dataHora": "2026-04-30T15:00:00.688",
        "nsu": "000000214",
        "autorizacao": "164550",
        "bandeira": "MASTERCARD",
        "adquirente": "Getnet"
      }
    }
  ],
  "pinPdv": { "id": 1, "codigo": "449263", "nome": "CAIXA 01" },
  "isCancelamento": false
}

Os valores de status, tipoVenda e pagamentoTipo estão em Referência.