---
title: "How to Test Paddle Payments in WooCommerce (Sandbox)"
description: "Test Paddle in WooCommerce with a sandbox account: connect it, pay with a Paddle test card, refund the order, then switch the gateway to Production."
pubDate: 2026-11-18
source: https://pimipay.com/blog/paddle-sandbox-woocommerce/
---

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](https://sandbox-vendors.paddle.com/signup) 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](/docs/installation/#api-key-permissions), 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](/docs/configuration/), [webhooks](/docs/webhooks/#setup) and [product sync](/docs/product-sync/#sync-all) 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](https://developer.paddle.com/concepts/payment-methods/credit-debit-card). Use any cardholder name and any expiry date in the future. Real cards are rejected in the sandbox.

| Card number | What it does |
| --- | --- |
| 4242 4242 4242 4242 | Payment succeeds, no 3-D Secure |
| 4000 0038 0000 0446 | Payment succeeds after a 3-D Secure step |
| 4000 0000 0000 0002 | Payment is declined |
| 4000 0027 6000 3184 | First 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](/docs/webhooks/#health) 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](/docs/refunds/#approval).

## 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](https://portal.w4dev.com/checkout/?add-to-cart=8746&utm_source=pimipay.com&utm_medium=referral&utm_content=blog).

## 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.