Framework-agnostic webhook ingress. The host app supplies the RAW request
body string (exactly as received — express.raw / fastify rawBody /
await req.text() in Next.js App Router; see the README recipes) plus the
headers, and translates the returned status to its framework's response.
Ack-fast contract: the handler only verifies the signature, parses the event,
and hands it to onEvent. onEvent must ENQUEUE and return — respond 2xx
immediately and defer heavy processing. Paysafe in particular retries
effectively forever until it sees a success response.
Framework-agnostic webhook ingress. The host app supplies the RAW request body string (exactly as received — express.raw / fastify rawBody /
await req.text()in Next.js App Router; see the README recipes) plus the headers, and translates the returned status to its framework's response.Ack-fast contract: the handler only verifies the signature, parses the event, and hands it to
onEvent.onEventmust ENQUEUE and return — respond 2xx immediately and defer heavy processing. Paysafe in particular retries effectively forever until it sees a success response.