Skip to content
Blog

How to Test Paddle Payments in WooCommerce (Sandbox)

Paddle has a sandbox: a separate account where checkouts run with test cards and no real money moves. With PimiPay, the Paddle gateway for WooCommerce, the sandbox is where a new install starts. This post walks one test order through it, then lists what changes when you go live.

What the Paddle sandbox is

The sandbox is its own account with its own dashboard, products, API keys and webhooks. A live Paddle account does not include one, so you sign up for the sandbox separately. It needs no website approval, which means you can test while Paddle is still reviewing your domain for live payments.

Connect WooCommerce to the sandbox

In PimiPay the sandbox is the Staging environment, and it is the default.

  1. In the sandbox dashboard, create an API key with the eight permissions the plugin needs, and set a default payment link under Checkout settings.
  2. In WooCommerce, go to Settings, Payments, Paddle. Leave Environment on Staging, then paste the sandbox Seller ID and API Key. Tick Enable Paddle and save changes.
  3. Click Register Webhook. The plugin creates the webhook in your sandbox account and saves its secret.
  4. Sync your products from the gateway settings, or use Sync with Paddle on a product’s row in the Products list. Paddle is only offered at checkout for products that are in Paddle.

Each step is covered in the configuration, webhooks and product sync docs.

Place a test order

Add a synced product to the cart and go to checkout. While the gateway is on Staging, the Paddle option carries a red TEST MODE note, and WooCommerce shows a Test mode badge beside Paddle in its payments list.

Place the order and pay with one of Paddle’s test cards. Use any cardholder name and any expiry date in the future. Real cards are rejected in the sandbox.

Card numberWhat it does
4242 4242 4242 4242Payment succeeds, no 3-D Secure
4000 0038 0000 0446Payment succeeds after a 3-D Secure step
4000 0000 0000 0002Payment is declined
4000 0027 6000 3184First payment succeeds, later ones are declined

What to check

  • The order is paid. The WooCommerce order moves out of Pending payment, and the order screen shows the Paddle transaction ID, linked to the sandbox dashboard.
  • The webhook arrived. The Webhook health box in the gateway settings shows the last delivery and its result.
  • A declined card leaves the order unpaid. Try the declined card once.
  • A refund comes back. Refund the order from WooCommerce. Paddle approves sandbox refunds automatically, in batches about every ten minutes, so the order may wait a few minutes before it shows as refunded. Live refunds can take longer; see the refunds docs.

Switch to Production

Going live is the same screen with the other environment selected.

  1. In your live Paddle account, get your domain approved and set a default payment link.
  2. Set Environment to Production and paste the live Seller ID and a live API key.
  3. Click Register Webhook again. Webhooks are per environment.
  4. Sync your products again. The plugin stores sandbox and live Paddle IDs separately on each product, so nothing synced in the sandbox exists in your live account yet.

Your Staging settings stay saved, so you can switch back later to test a change without re-entering anything.

The plugin is $59 a year, with a 30-day money-back guarantee: buy it here.

FAQ

Do I need a separate account for the Paddle sandbox?

Yes. The sandbox is its own account, and you sign up for it separately from a live Paddle account. No real money moves in it.

Can I test Paddle in WooCommerce before my domain is approved?

Yes. The Paddle sandbox needs no website approval, so with PimiPay on the Staging environment you can run test orders while Paddle reviews your domain.

Which test card works in the Paddle sandbox?

4242 4242 4242 4242 succeeds without 3-D Secure. Use any cardholder name and any future expiry date. Paddle lists more cards for 3-D Secure and declines.

Ready to add Paddle for WooCommerce?

Install the WooCommerce Paddle plugin and start accepting payments on your store today.

Buy now