Testing WooCommerce Payments

WooCommerce Payments is available to stores based in the US. Based outside the US? Request to be notified when it becomes available in your country.

WooCommerce Payments provides a payment gateway with an integrated dashboard for managing transactions. This document provides instructions for testing payments, and payment-related functionality with WooCommerce Payments. To learn more about WooCommerce Payments, including how to set it up on your store, see the start up guide.

Enable Test Mode ↑ Back to top

Testing on a development site? Create a test account with Dev Mode.

By default, WooCommerce Payments operates in Live Mode to accept real debit or credit cards. To test payments or disputes, or view transactions previously processed in test mode, you need to switch WooCommerce Payments into Test Mode.

To enable Test Mode:

  1. Go to Payments > Settings
  2. Click Test Mode
  3. Click Save changes
Payments > Settings screen to enable Test Mode

Don’t forget to disable Test Mode when you’re ready to start accepting real payments or to view real transactions.

Test Transactions ↑ Back to top

When Test Mode is enabled, the Payments administration screens will display only test transactions. This includes transactions shown on the Deposits, Transactions and Disputes screens.

To help track when a screen is being viewed with Test Mode enabled, a notice is displayed at the top of the screen.

Payments > Transactions test mode example screenshot

Test Card Payments ↑ Back to top

To simulate a payment with WooCommerce Payments:

  1. Enable Test Mode if it’s not already enabled.
  2. Go to your shop page
  3. Add a product to the cart.
  4. Go to your store’s checkout page (e.g. example.com/checkout/).
  5. Complete checkout form fields.
  6. Enter the number of test card below.
  7. Enter any date in the future.
  8. Enter any 3 digit CVC, other than 123.
  9. Click Place order.
  10. Go to Payments > Transactions in your store’s administration dashboard. You should see the Charge show up.

The order will be processed as if using a real credit card.

Test card numbers

The following test card numbers can be used with:

  • Any date in the future as the expiration month / year
  • Any 3 digit CVC value
NumberCard Brand
4242 4242 4242 4242Visa
4000 0566 5566 5556Visa (debit)
5555 5555 5555 4444Mastercard
5105 1051 0510 5100Mastercard (prepaid)
3782 8224 6310 005American Express
6011 1111 1111 1117Discover

International test card numbers

Cards issues outside the US incur an additional 1% fee when used with US based merchants. To test an international payment, the following Visa branded test card numbers can be used with:

  • Any date in the future as the expiration month / year
  • Any 3 digit CVC value
NumberCountry
4000 0007 6000 0002Brazil (BR)
4000 0012 4000 0000Canada (CA)
4000 0048 4000 8001Mexico (MX)

Test Refunds ↑ Back to top

To test a refund:

  1. Complete the steps to Test Card Payments.
  2. Go to WooCommerce > Orders.
  3. Click the order ID of the order created with a test card.
  4. Click Refund.
  5. Enter the refund amount & reason (optional).
  6. Click Refund via WooCommerce Payments.
  7. Go to Payments > Transactions.
  8. Confirm the refund transaction is listed.
Refund via Edit Order screen example screenshot

Test Manual Captures ↑ Back to top

To test a card payment authorization with manual capture:

  1. Go to Payments > Settings.
  2. Enable Manual Capture.
  3. Complete the steps to Test Card Payments.
  4. Go to WooCommerce > Orders.
  5. Click the order ID of the order created with a test card.
  6. Confirm the order has a note saying: A payment of $xx.xx was authorized using WooCommerce Payments.
  7. Click Choose an action.
  8. Click Capture charge.
  9. Click Update.
  10. Confirm the order has a note saying: A payment of $39.00 was successfully captured using WooCommerce Payments.
  11. Go to Payments > Transactions.
  12. Confirm a transaction with type Charge is listed.
Capture Charge action on Edit Order screen example screenshot

Test Disputes ↑ Back to top

To simulate a dispute with WooCommerce Payments:

  1. Enable Test Mode if it’s not already enabled.
  2. Go to your shop page
  3. Add a product to the cart.
  4. Go to your store’s checkout page, e.g. example.com/checkout/
  5. Complete checkout form fields.
  6. Enter one of the test card numbers that results in a dispute.
  7. Click Place order.

The order will be processed as if using a real credit card. The payment will be immediately disputed. You can then view and respond to the dispute by going to Payments > Disputes in your WordPress dashboard.

Test cards for disputes ↑ Back to top

The following card numbers can be used with:

  • Any date in the future as the expiration month / year
  • Any 3 digit CVC value
NumberScenario
4000 0000 0000 0259Payment disputed as “Fraudulent.”
4000 0000 0000 2685Payment disputed as “Product Not Received.”

Test dispute responses ↑ Back to top

After creating a dispute with a dispute test card, to test dispute responses:

  1. Go to Payments > Disputes
  2. Click ⓘ next to the dispute
  3. Click Challenge Dispute
  4. In the Additional Details field:
    1. Enter winning_evidence to win the dispute
    2. Enter losing_evidence to lose the dispute
Payments > Disputes administration screen example screenshot

Frequently Asked Questions ↑ Back to top

Is WooCommerce Payments compatible with WooCommerce Subscriptions? ↑ Back to top

At the moment, WooCommerce Subscriptions is not supported. Our developers are working on this and it will be included in a future release.

WooCommerce - the most customizable eCommerce platform for building your online business.

Back to the top