Examples / Payments and billing / Paddle

Paddle webhooks

Transactions, subscriptions, adjustments and customer changes from a merchant of record.

Events

transaction.completed
subscription.activated
subscription.canceled
adjustment.created

Signature

Header Paddle-Signature with ts=<timestamp>;h1=<hex>. HMAC-SHA256 of '<ts>:<raw body>' with the endpoint secret.

✓ A bin checks Paddle signatures: add the endpoint secret key under Signature verification (Paddle).

Retries

Paddle retries up to 60 times over about 3 days.

See a retry schedule in the calculator.

Docs

developer.paddle.com/webhooks/overview

Checked 2026-10-08. Report a change.

Sample request from Paddleillustrative, shortened

Content-Typeapplication/jsonPaddle-Signaturets=1759924800;h1=9a3f…c7d0

{
  "event_id": "evt_01h8bzakzx3hm2fmen703n5q45",
  "event_type": "transaction.completed",
  "occurred_at": "2026-10-08T06:34:00.123Z",
  "data": {
    "id": "txn_01h8bxryv3065dyh6103p3yg28",
    "status": "completed",
    "customer_id": "ctm_01h8bxs9x3x1k2c4b7m6n9p0q1",
    "details": { "totals": { "total": "1800", "currency_code": "USD" } }
  }
}

Receive Paddle webhooks with webhooks.xyz

Create a bin. Paste its URL into Paddle. Each request shows at once with its headers and body. Add your server as a destination, and deliveries retry when it is down. Request an invite.

More in payments and billing: GoCardless, PayPal, Razorpay, Square, Stripe.