Running test orders

By placing a test order, you can see what checkout is like for your customers or donors. You can also confirm if your store setup is working as you expected, including shipping, taxes, custom forms, and notification emails.

There are two options for test orders:

• Recommended: Place a real order and immediately refund yourself - For credit/debit card and PayPal transactions
• Advanced: Use test mode to simulate a charge with a fake credit card - This effectively disables your store and prevents you from accepting any real payments. For credit/debit card transactions only. 

Note: Depending on your billing plan, you may be charged a non-refundable Squarespace Commerce transaction fee when placing then refunding a real order. There are no Squarespace Commerce transaction fees in test mode.

Requirements

• You must have at least one product in your store or a Donation Block to go through checkout.
• If you sell physical products, you must have at least one shipping option.
• Your site should already be connected to a payment processor.
• If your site is private, you may see a 404 error message after checkout. To resolve this, change your site availability to public, or enable Checkout on your Domain. 

Fees

There’s no extra charge for test orders, but note the following before placing a real order and refunding yourself:

• Testing PayPal - You’ll receive a full refund for the order items and the Squarespace Commerce transaction fee. You’ll receive a partial refund from PayPal. PayPal withholds the fixed transaction fee (for example, $0.30 for U.S.-based accounts).
• Testing Stripe - You’ll receive a refund for the order items and the Squarespace Commerce transaction fee. Stripe doesn't refund transaction fees.

Option 1 - Place an order and refund yourself

We recommend this approach for most scenarios. Before you start selling, you should always run a real charge to ensure your store is set up correctly. This option is available for credit card and PayPal transactions.

Note: When testing a PayPal transaction, pay with a separate personal PayPal account. It isn’t possible to pay using the PayPal Business account connected to your store.

Step 1 - Place an order

1. Add any item to your cart, or click a Donation Block button, and proceed to checkout as a customer or donor would. For more help, visit How customers buy your products.
2. At checkout, enter your contact and shipping information.
3. At the Payment section, select Credit Card or PayPal, depending on your setup.
4. Enter real credit card details or log into a personal PayPal account to pay.
5. Follow the prompts to complete your order.
6. You should receive an order confirmation email for your order or donation.

Step 2 - Cancel and refund the order

After you’re done reviewing the test order, follow these steps to cancel it and refund yourself:

Tip: To refund a donation, visit Managing donations.

1. In the Home Menu, click Commerce, and then click Orders. You can also press the ? key while any panel is open and search orders.
2. Find and open your order. If you just placed the order, it should be at the top of the panel labeled as Pending.
3. Click Cancel Order in the order summary to issue a refund. For detailed steps, visit Cancelling and refunding an order.

Option 2 - Use test mode (Stripe only)

Note: Your store can’t accept real payments while in test mode.

We recommend this approach for advanced situations, such as when you’re running many test orders. This option is only available for orders or donations processed through Stripe. You can use test mode for Apple Pay with real credit card details (you will not be charged in test mode). You can't use test mode for PayPal or Venmo transactions.

Step 1 - Enable test mode

1. In the Home Menu, click Commerce, and then click Payments.
2. Click Test Mode.
3. Switch the toggle to ON.
4. Click Save.

Step 2 - Place an order

1. Add any item to your cart, or click a Donation Block button, and proceed to checkout as a customer or donor would. For more help, visit How customers buy your products.
2. At checkout, you’ll see a Test Mode banner.

3. Enter your contact and shipping information.
4. At the Payment section, a test credit card number will automatically populate.

Note: If you select PayPal and click Continue with PayPal, you’ll see a message saying that you can’t place PayPal orders while in test mode.

5. Follow the prompts to complete your order.
6. You should receive an order confirmation email for your order or donation.

Step 3 - Review and clear the test order

To clear a test Commerce order:

1. In the Home Menu, click Commerce, and then click Orders. You can also press the ? key while any panel is open and search orders.
2. Find your order. If you just placed the order, it should be at the top of the panel labeled as Pending and Test Order.
3. To clear it, check it and click Delete Test Order.

To clear a test donation:

1. In the Home Menu, click Donations.
2. Click Clear test donations.
3. Click Confirm.

Step 4 - Disable test mode

We recommend disabling test mode soon after you’re done testing so customers can check out with real credit cards and you can accept real payments. When your store stays in test mode, customers can still complete checkout, but they’ll skip entering their payment information and use the fake credit card instead. This can be a confusing experience (and might lead to lost revenue).

To disable test mode:

1. In the Home Menu, click Commerce, and then click Payments.
2. Click Test Mode.
3. Switch the toggle to OFF.
4. Click Save.

 

Delete or hide test orders

Test orders will display a Test label. To delete or hide test orders:

• Desktop
• iOS Commerce App
• Android Commerce App

In the Orders panel, find the test order and click Delete test order. This permanently deletes the test order.

Adjust your iPhone's settings:

1. From your iPhone's home screen, tap Settings.
2. Scroll down and tap Commerce.
3. Under App settings turn the Display Test Orders toggle off. It will turn white when when it's disabled.

This hides test orders from the Orders tab. You can delete them permanently from your desktop site.

You can't delete test orders in the Android App. Instead, visit the Orders panel on your desktop site.

Gift card test orders

To test the purchase and use of a gift card, enable test mode using the steps in Option 2. Then purchase a gift card and proceed to checkout as a customer would. For more help, visit How customers use gift cards.

After purchasing the gift card, you can use the gift card code to purchase any item from your store. When you're finished, disable test mode.

Note: Gift cards purchased in test mode can't be used on a live store.

If customers place orders in test mode

If you don't disable test mode before making your site public, customers may complete the checkout process while in test mode. This will place a test order on your site, but won't charge the customer's credit card. If this happens, follow these steps to resolve the issue: 

1. Disable test mode.
2. Delete the test order.
3. Replenish the stock levels for the item.
4. Contact the customer. They'll need to re-purchase the product.

General tips

• Test orders deplete stock for the purchased items.
• If your store isn’t live, all orders will be test orders.
• Test orders are assigned order numbers, which can't be deleted. There's no way to reset your order number to zero after you run test orders.
• If you're on a trial, you can connect Stripe and run orders in test mode only.
• Analytics doesn’t factor in refunds at this time, so placing a real order and refunding yourself will count toward your totals in Analytics.
• If you place a test order for a subscription product, ensure you cancel the subscription after refunding the order.
• If you run a test order on a password protected or private site, you'll see a lock screen instead of an order confirmation page after placing the order.