Testing WooCommerce Payments

WooCommerce Payments is currently available only to select merchants. Want to try it out? Request an invite.

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

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
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
Payments > Disputes administration screen example screenshot

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

Back to the top