Webhook Reference

Our webhooks make it simple to receive data and events from Paddle, and for your systems to communicate data back.

Paddle sends:

  1. Fulfillment Webhooks – generated during order processing for one-time products or subscription plans.
  2. Alert Webhooks – triggered by events in the Paddle platform, for example a successful payment or a balance transfer to your bank account.

Before you receive any events, you need to define the URL that we should send the HTTP POST requests to. POST requests will have a content-type of application/x-www-form-urlencoded.

  • Step 1: Click Developer Tools in the navigation in your Seller Dashboard.
  • Step 2: Click on the Alerts / Webhooks item.
  • Step 3: Enter a URL that we should send the HTTP POST requests to (or set an email if you wish to receive email notifications).
  • Step 4: Check each alert that you wish to receive a notification for.
  • Step 5: Click the "Save Changes" button to confirm your alerts.

For webhook events / alerts, your server should respond within 10 seconds with a HTTP 200 status code to indicate you have successfully received the message. If we receive anything other than a HTTP 200 (or if there is no response within 10 seconds) we will retry the call to your webhook URL every 15 minutes for a maximum of 3 days.

Check the log of fulfillment and alert webhooks sent from your account by going to Developer Tools > Alerts / Webhooks > Alert History or fetch alert history via our API.