Keys / Paddle
PADDLE_API_KEY
The Paddle Billing API key your backend calls the Paddle API with. Sandbox keys start with pdl_sdbx_, live keys with pdl_live_.
- Starts with
pdl_- Expires
- you choose, up to 1 year; 90 days by default
- API
- list, get and rotate rotatable keys; no create or revoke
Get it
Create one on developer.paddle.com/api-reference/about/authentication. The steps aren't recorded yet.
Set it
PADDLE_API_KEY=pdl_...
No official Paddle SDK reads it; your app passes the key in. Or keep it out of .env with keypin: keypin run -- npm run dev
Replace it
- If the key is rotatable, rotate it with
POST /api-keys/{id}/rotationsand a grace period of up to 24 hours. The key keeps its ID and permissions; only the secret changes. - Deploy the new secret everywhere that reads
PADDLE_API_KEY. The old secret stops on its own at the rotation'sexpires_at, so don't revoke the key: that would stop the new secret too. - If the key isn't rotatable, create a new rotatable key with the same permissions under Paddle > My account > Settings > Authentication, deploy it, then revoke the old key once its last used date shows nothing uses it.
Set rotate_every on the key in keypin.toml and a rotated date on its vault item, and keypin status shows when it's due.