DocsPlugins
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:
sluurp plugin add payments payments-paddleSet up a payee
- 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. - In Paddle, add a notification destination at the address the admin shows,
/api/payments/webhook/paddle/<payee>, and copy its secret (pdl_ntfset_…). - In Paddle’s checkout settings, approve your site’s address.
- 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.