Subscribe to notifications for payouts

What's new?

We added two new events that you can subscribe to:

• payout.created

  Occurs when a payout from Paddle is initiated. This means the transfer of money is in progress.

• payout.paid

  Occurs when a payout is paid. This means it has been paid into your bank, so you should see it the next working day.

How it works

Paddle initiates payouts on the 1st of each month. They're usually completed some time between the 2nd-15th of the month.

You can track payouts from the Paddle dashboard by going to Paddle > Business account > Payouts.

The new payment.created and payment.paid events let you subscribe to notifications for payouts, meaning you can build workflows using your payout data. For example, you could pipe data to your accounting solution or create a notification in Slack.

Examples

1
2
3
4
5
6
7
8
9
10
11
12
1{
2  "event_id": "evt_01h2b0tqg1xkgnkfmprsnrjn0s",
3  "event_type": "payout.paid",
4  "occurred_at": "2023-06-07T13:30:38.138984Z",
5  "notification_id": "ntf_01h2b0tqkhfqd094y9pys30xyw",
6  "data": {
7    "id": "pay_01gsz4vmqbjk3x4vvtafffd540",
8    "status": "paid",
9    "amount": "10000",
10    "currency_code": "USD"
11  }
12}

Next steps

This change is available in version 1 of the Paddle API.

It's a non-breaking change, meaning it doesn't impact existing integrations.

You can create a notification destination for the new payout events by going to Paddle > Developer tools > Notifications, or by using the create a notification destination operation in the Paddle API.

Learn more