Hook & Sense plans are opening to early access.
Request access

Paddle Webhooks

How to Test Paddle Webhooks Locally (2026)

Paddle Billing sends webhooks for transaction, subscription, and customer events. Paddle signs each webhook with HMAC-SHA256 using your notification destination's secret key; the Paddle-Signature header carries a timestamp and the signature in a ts=...;h1=... format.

With HookSense, point Paddle at a callback endpoint and let an AI agent await the result over MCP: create_callback_endpoint → wait_for_callback → verify_signature. Run npx @hooksense/mcp in Claude Desktop, Cursor, or any MCP client. No polling.

Signature Header

Paddle-Signature

Algorithm

HMAC-SHA256 (signed payload: timestamp:rawBody)

Setup Guide

  1. 1Create a free HookSense endpoint at hooksense.com
  2. 2Copy your unique webhook URL
  3. 3In Paddle → Developer Tools → Notifications → New destination
  4. 4Paste your HookSense URL and select the events you want to receive
  5. 5Copy the destination's secret key (pdl_ntfset_...) and add it to HookSense
  6. 6Use Paddle's 'Send simulated event' to fire a test webhook
  7. 7Watch the webhook appear in HookSense in real-time

Common Paddle Webhook Events

transaction.completed
transaction.paid
transaction.billed
subscription.created
subscription.updated
subscription.canceled
subscription.past_due
customer.created

Forward to Localhost

Use HookSense CLI to forward Paddle webhooks directly to your local development server:

npx hooksense listen -p 3000 --path /api/integrations/paddle

No ngrok or tunnel setup required. Install with npm i -g hooksense or use npx.

Tips & Best Practices

  • The signed payload is timestamp:rawBody — verify against the raw, unparsed body
  • Paddle enforces a 5-second timestamp tolerance by default to block replay attacks
  • This is for Paddle Billing — Paddle Classic uses a different (RSA p_signature) scheme
  • Use HookSense's simulated-event captures to build CI fixtures for subscription lifecycle tests

Related

Paddle Webhook Documentation Paddle webhook tester — send sample events HMAC signature calculator
Webhook SignatureRaw Body2xx ResponseIdempotency

Give your agent a Paddle callback

Create a free callback endpoint and have an agent await its first verified Paddle webhook over MCP. Paid plans are early-access.

Get Started Free