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

  1. If the key is rotatable, rotate it with POST /api-keys/{id}/rotations and a grace period of up to 24 hours. The key keeps its ID and permissions; only the secret changes.
  2. Deploy the new secret everywhere that reads PADDLE_API_KEY. The old secret stops on its own at the rotation's expires_at, so don't revoke the key: that would stop the new secret too.
  3. 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.

Sources, checked 2026-11-16