Alerts are notifications Paddle sends out after an event occurs. They are also a key way of integrating subscription services with Paddle. You can subscribe to a wide-range of seller alerts by visiting the Alerts / Webhooks page in your Paddle dashboard.
You can choose to have alerts sent to you via email, webhook or both.
If you choose to subscribe to alerts via email, by default these will be sent to the vendor email address you used during sign-up. You can check what your vendor email address is by selecting ‘Account Settings’ in the menu on the Vendor Settings page in your dashboard, and going to ‘Email’.
Alternatively, you can choose a different email address for receiving email alerts on the ‘Alerts’ page itself, by using the ‘Email address for receiving email alerts’ field under ‘Receiving Alerts’.
If you choose to subscribe to alerts via webhook, you can also do so by entering the URL in the ‘URL for receiving webhook alerts’ field under ‘Receiving Alerts’.
A full list of alerts can be seen below:
Subscription
- Subscription Created
- Subscription Updated
- Subscription Cancelled
- Subscription Payment Succeeded
- Subscription Payment Failed
- Subscription Payment Refunded
One-off Purchase
- Payment Succeeded
- Payment Refunded
- Order Processing Completed
Risk & Dispute (Chargeback)
- Payment Dispute Created
- Payment Dispute Closed
- High Risk Transaction Created
- High Risk Transaction Updated
Payout
- Transfer Created
- Transfer Paid
Audience
- New Audience Member
- Update Audience Member
Manual Invoicing
- Invoice Paid
- Invoice Sent
- Invoice Overdue
With each alert, various data is sent. For example, with the “payment succeeded” alert you’ll receive data such as order_id, email, passthrough information, product_name and more.
You can learn more information about the different alerts by hovering over the tooltip (i) icon. Further details on these alerts can be found on our Webhook Reference documentation here.
Webhook simulator
Select the Webhook Simulator button (or click here) to access this tool. The Webhook Simulator will allow you to see what data is sent with each alert webhook, and simulate alert webhooks in order to successfully integrate these with your system.
For example, if you want to test a subscription plan and see which data is sent when a customer signs up so you can enable their access to your product or service, using the Webhook Simulator will allow you to see how you can build your integration to facilitate this.
Alert History
Select the Alert History button (or click here) to access this tool. You can check a log of all alerts sent out by Paddle using this. You can also use this to retry any alerts which failed to process in the event that you experienced system issues.