constructEvent verifica a assinatura e interpreta o JSON. A função usa node:crypto e não faz chamadas à API.
Handler de referência
O handler abaixo recebe duas dependências: o segredo e uma funçãopersist que grava em banco ou fila durável. O exemplo só confirma entregas após essa gravação. A implementação de persistência pertence à sua aplicação.
webhook.ts
Use com Next.js
Exporte o handler comoPOST no arquivo app/api/webhooks/sinnu/route.ts. Declare export const runtime = "nodejs" e conecte sua persistência. Não use request.json() antes de verificar a assinatura.
Verifique também o conteúdo
O parâmetro genérico deconstructEvent<T> informa tipos ao TypeScript, mas não valida T em runtime. Confira os campos usados pela sua aplicação antes de processar.
O worker deve consultar a transação, conferir o pedido e impedir liberação duplicada. Veja a receita de conciliação.