All guides

Webhooks guide

Test Paddle webhooks with the webhook simulator

Paddle's webhook simulator can send one event or a multi-event lifecycle scenario without a real purchase. PNTR acts as the simulation destination so you can inspect the sequence before connecting your application handler.

Explore PNTR's online webhook tester

Simulation destination

https://yourname.pntr.dev/paddle

Setup

  1. 1

    Create a capture endpoint

    Create a PNTR webhook hostname and copy a URL such as https://yourname.pntr.dev/paddle. PNTR stores each simulated request and returns a 200 acknowledgement.

  2. 2

    Create a simulation-enabled destination

    In Paddle Developer tools, create a URL notification destination using the PNTR endpoint. Its usage must allow Simulation or Platform and simulation traffic.

  3. 3

    Create the simulation

    Open the Simulations area, choose the PNTR destination, then select either a single event or a lifecycle scenario such as subscription creation.

  4. 4

    Run and inspect the sequence

    Run the simulation and open PNTR's request log. For scenarios, use timestamps and event identifiers to understand the order of the multiple deliveries.

  5. 5

    Repeat against the real handler

    Move the destination to your application endpoint, replay the simulation, verify Paddle-Signature, return 200 quickly, and make event processing idempotent.

Before you ship

A successful capture proves Paddle reached the URL; it does not test signature verification or business-state changes. Save the destination secret when Paddle displays it and use it only in your real handler.

Primary documentation