---
title: Paddle
description: Paddle for Payments: a merchant of record that charges the sales tax and pays it where it is due, with its checkout on a page of your server's.
section: Plugins
order: 43
---

# Paddle

Paddle for Payments: a merchant of record that charges the sales tax and pays it where it is due, with its checkout on a page of your server's.

The `payments-paddle` plugin lets the Payments plugin take payments with Paddle. Paddle sells to the buyer itself, so the sales tax of every country is its to charge and pay. To add it:

```sh title="Terminal"
sluurp plugin add payments payments-paddle
```

## Set up a payee

1. In Paddle, open **Developer tools**, then **Authentication**, and make an API key and a client-side token. A sandbox key (`pdl_sdbx_…`) pays in Paddle's sandbox.
2. In Paddle, add a notification destination at the address the admin shows, `/api/payments/webhook/paddle/<payee>`, and copy its secret (`pdl_ntfset_…`).
3. In Paddle's checkout settings, approve your site's address.
4. In the admin, open **Payments**, add a payee with provider **Paddle**, and paste the key, the secret and the client-side token.

Paddle's checkout opens on a page your server serves, `/api/payments/page/<payee>`, which is why the payee needs the client-side token and the site needs approving.

A webhook call is believed only when Paddle signed it with the secret and it is fresh. Full refunds and chargebacks that Paddle approves are recorded against the payment.

Taking payments in your app is the same for every provider: see Payments.
