2021 Q4 Sale BFCM – Free Users Sitewide Banner

  1. Documentation
  2. WooCommerce Payments

Testing WooCommerce Payments

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

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 ↑ Back to top

To test payments, 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

Country specific test card numbers ↑ Back to top

Cards issued outside the country or region of the WooCommerce Payments account can incur an additional fee. 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 0003 6000 0006Australia (AU)
4000 0004 0000 0008Austria (AT)
4000 0005 6000 0004Belgium (BE)
4000 0007 6000 0002Brazil (BR)
4000 0012 4000 0000Canada (CA)
4000 0025 0000 0003France (FR)
4000 0027 6000 0016Germany (DE)
4000 0037 2000 0005Ireland (IE)
4000 0038 0000 0008Italy (IT)
4000 0048 4000 8001Mexico (MX)
4000 0052 8000 0002Netherlands (NL)
4000 0055 4000 0008New Zealand (NZ)
4000 0061 6000 0005Poland (PL)
4000 0062 0000 0007Portugal (PT)
4000 0072 4000 0007Spain (ES)
4000 0075 6000 0009Switzerland (CH)
4000 0082 6000 0000United Kingdom (UK)
4000 0582 6000 0005United Kingdom (UK) – Visa Debit

Supported Card Brands ↑ Back to top

WooCommerce Payments supports all the cards that are supported by Stripe itself. Please head over to Card brand capabilities section of the Stripe documentation for more details.

3D Secure Test Card Numbers ↑ Back to top

The following card numbers can be used to test payments that require additional verification step via both checkout and the Pay for Order pages.

To test 3D Secure transactions, these test card numbers can be used with:

  • Any date in the future as the expiration month / year
  • Any 3 digit CVC value
NumberAdditional Verification
4000 0000 0000 3220Required.
4000 0000 0000 3055Supported, not required.
3782 8224 6310 005Not supported.

Testing Deposits ↑ Back to top

You may need to conduct test payments at some time to ensure that deposits are operating properly. For most Stripe users, there is no minimum deposit amount. However, there are some exceptions – Please refer to the following Stripe documentation page to know more details.

Test Payment Request buttons ↑ Back to top

Test Apple Pay in Safari ↑ Back to top

To learn how to simulate a test purchase with Apple Pay, please head over to Testing Apple Pay.

Test Payment Request button in Chrome, Edge, Opera or Brave ↑ Back to top

To test paying with Payment Request buttons with WooCommerce Payments:

  1. Enable Test Mode if it’s not already enabled.
  2. Add a test card to your browser’s payment methods.
  3. Go to a product page and click the “Buy now” button.
  4. Enter checkout details in the Payment Request dialog.
  5. Click Pay.
  6. Go to Payments > Transactions in your store’s administration dashboard. You should see the Charge show up.

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

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

  • 30 day money back guarantee
  • Support teams across the world
  • Safe & Secure online payment