> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firstpromoter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Paddle

> Connecting FirstPromoter with Paddle

`Difficulty: Easy` <br />
`Developer Required: No`

FirstPromoter supports both **Paddle Classic** (v1 webhooks) and **Paddle Billing** (v2 webhooks), and automatically tracks sales, refunds, and cancellations from your Paddle account.

**Paddle Classic (v1) — tracked webhook events:**

| Paddle Event                     | What FirstPromoter tracks     |
| -------------------------------- | ----------------------------- |
| `payment_succeeded`              | Sale / commission             |
| `subscription_payment_succeeded` | Sale / commission (recurring) |
| `payment_refunded`               | Refund                        |
| `subscription_payment_refunded`  | Refund (recurring)            |
| `subscription_cancelled`         | Cancellation                  |

**Paddle Billing (v2) — tracked webhook events:**

| Paddle Event            | What FirstPromoter tracks |
| ----------------------- | ------------------------- |
| `transaction.completed` | Sale / commission         |
| `adjustment.created`    | Refund                    |
| `adjustment.updated`    | Refund                    |
| `subscription.canceled` | Cancellation              |

Click [here](https://login.firstpromoter.com?redirect=%2Fintegration%2Fpaddle) to view the setup guide.
