Setup and test your Paddle integration in Paddle’s Sandbox environment. You can use our test cards below to test end-to-end workflows.
Paddle Sandbox is completely separate from the Paddle Production environment. This means products/plans and dashboard settings will need to be configured independently in each environment.
Do not attempt to set up or fulfill live products or services from Paddle Sandbox, as real payment methods cannot be used. This means buyers cannot be charged nor does Paddle payout from Sandbox accounts.
Create Sandbox account
In order to test Paddle, you will first need to create an account on our Sandbox environment here.
Launching the Paddle Checkout
Please do not self-host Paddle.js, this will prevent you from receiving bug fixes and new features.
Sandbox API calls
To make API calls to your Sandbox environment you must add the
sandbox- prefix in the URL hostname. For example:
Real card information cannot be used in the Paddle Sandbox. For the test cards below, enter a valid expiration date in the future, and any random CVC number. Each test card’s billing country is set to U.S.
|Card Type||Card Number|
|Valid card without 3DS||
|Valid card with 3DS||
Paddle’s checkout supports payments via PayPal. To make test transactions using PayPal, you will need to first create a PayPal Sandbox account. You can then enter your PayPal sandbox credentials into the Paddle checkout to complete test transactions.
Moving to Production
When moving from Sandbox testing to Production there a few things to remember.
- Remove “sandbox-” prefix from the API endpoints
- Update Vendor ID
- Update API Auth key
- Update Product/Plan IDs
- Update Whitelisted webhook alert IPs (if used)
We recommend having two sets of application settings, one for Sandbox and one for Production to help avoid mistakes and facilitate future testing where necessary.