New — webhooks your AI agents can wait on. Hook & Sense 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