Sandbox Credentials and Environments Setup
To test checkout flows, subscription upgrades, and webhook listeners without charging real money, configure a Paddle Sandbox account.
1. Creating a Sandbox Account
- Go to sandbox-login.paddle.com and sign up for a free developer sandbox account.
- Verify your developer email.
- Access the Sandbox dashboard workspace.
2. Locating API Credentials
In the Paddle Sandbox console side navigation, navigate to Developer Settings to retrieve these keys:
- Client Token: A public token prefix (starting with
pt_...) used by the client-side JavaScript SDK (Paddle.js) to render checkout forms. - API Secret Key: A private key (starting with
paddlesd_...) used by your backend APIs to configure products or trigger billing updates. - Webhook Secret Key: A unique verification string used to check signature headers on incoming payment event posts.
3. Environment Config Setup
Save your credentials inside your Next.js project .env.local configuration:
# Paddle SDK Client and Server variables config
NEXT_PUBLIC_PADDLE_CLIENT_TOKEN="pt_test_..."
PADDLE_API_SECRET_KEY="paddlesd_test_..."
PADDLE_WEBHOOK_SECRET_KEY="pwhsec_test_..."Published on Last updated: