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

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.

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

Number	Card Brand
4242 4242 4242 4242	Visa
4000 0566 5566 5556	Visa (debit)
5555 5555 5555 4444	Mastercard
5105 1051 0510 5100	Mastercard (prepaid)
3782 8224 6310 005	American Express
6011 1111 1111 1117	Discover

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

Number	Country
4000 0003 6000 0006	Australia (AU)
4000 0004 0000 0008	Austria (AT)
4000 0005 6000 0004	Belgium (BE)
4000 0007 6000 0002	Brazil (BR)
4000 0012 4000 0000	Canada (CA)
4000 0025 0000 0003	France (FR)
4000 0027 6000 0016	Germany (DE)
4000 0037 2000 0005	Ireland (IE)
4000 0038 0000 0008	Italy (IT)
4000 0048 4000 8001	Mexico (MX)
4000 0052 8000 0002	Netherlands (NL)
4000 0055 4000 0008	New Zealand (NZ)
4000 0061 6000 0005	Poland (PL)
4000 0062 0000 0007	Portugal (PT)
4000 0072 4000 0007	Spain (ES)
4000 0075 6000 0009	Switzerland (CH)
4000 0082 6000 0000	United Kingdom (UK)
4000 0582 6000 0005	United 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

Number	Additional Verification
4000 0000 0000 3220	Required.
4000 0000 0000 3055	Supported, not required.
3782 8224 6310 005	Not 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 ↑ 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.

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.

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

Number	Scenario
4000 0000 0000 0259	Payment disputed as “Fraudulent.”
4000 0000 0000 2685	Payment 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