RelayFox

How to test Paddle webhooks locally

Paddle fires webhooks for subscription events, payments, and refunds. Capture them with RelayFox to see the exact payload before writing your handler.

  1. 1
    Create a free RelayFox URL on the homepage (no signup needed).
  2. 2
    Paste it as your webhook endpoint: Paddle Dashboard → Developer Tools → Notifications → New Destination.
  3. 3
    Trigger an event (e.g. subscription.created) and watch it arrive live in RelayFox.
  4. 4
    Run the CLI to forward captured events to your local server:
    npx relayfox forward <endpoint-id> --to http://localhost:3000 --token rfx_...
  5. 5
    Inspect headers, body and replay any event as many times as you need.

RelayFox preserves the Paddle-Signature header when forwarding, so Paddle's signature verification works against your local server unchanged.

Get your Paddle webhook URL