“Invalid payment method” in WooCommerce: why the chosen gateway isn’t available
WooCommerce shows this when the order needs payment and the payment method that was submitted isn't in the list of methods available right now. Here is what decides that list, and what makes a method fall off it.
In this article13 sections
This notice means the order costs something, and the payment method sent with it isn’t one WooCommerce will accept for this order at this moment. Either nothing was selected, because no method was offered, or the selected method was available when the page loaded and isn’t any more.
The message doesn’t say which method or why. The causes below cover what removes a method from the list.
The exact message#
Invalid payment method.
The same failure can also read:
- Cash on delivery is not available for this order—please choose a different payment method
- No payment method provided.
Who sees it: Shoppers, after pressing Place order on the classic checkout, or Pay for order on an order payment page. Logged-in customers can also see it under My account > Payment methods when deleting a saved card or making one the default. The checkout block uses the two other wordings.
What WooCommerce checks#
When Place order is pressed and the total is above zero, WooCommerce builds the list of available payment methods:
- Each payment method under WooCommerce > Settings > Payments is asked whether it is available. The basic rule is that it is enabled. Each method can add its own rules, such as cart total, currency, country, shipping method or account setup.
- Plugins can then remove methods from the list through the
woocommerce_available_payment_gatewaysfilter. - If the submitted method isn’t in the final list, the order stops with this message. If it is, that method checks its own fields, such as card details.
Orders with a total of zero skip all of this, so free orders never show it.
Causes and how to fix each one#
1. No payment method is available at all#
If every method is disabled, or every enabled method declines this order, the checkout shows “Sorry, it seems that there are no available payment methods” and there is nothing to select. Pressing Place order then submits no method, and WooCommerce answers with this message. A payment plugin that isn’t fully set up, for example missing its account connection or not supporting your store’s currency, can decline without telling the customer why. That part is decided by the payment plugin, not by WooCommerce.
Check: Open the checkout as a customer and look at the payment area. Then check WooCommerce > Settings > Payments for methods that are enabled.
Fix: Enable a payment method, or finish setting up the one you use and check its own settings page for warnings.
2. The method dropped out after the customer changed something#
The available methods are worked out again for each order. Changing the shipping method, the country or the cart can remove a method the customer already selected. Cash on delivery set to Enable for shipping methods, or with Accept for virtual orders unticked, is the built-in example. If the order is submitted before the payment list refreshes, or the refresh fails, the old choice is sent.
Check: Repeat the customer’s steps: same address, same shipping method, same cart. Watch whether the payment method disappears.
Fix: Review the restrictions on that payment method, and offer another method for the cases it excludes.
3. The gateway has a maximum order amount or other limits#
WooCommerce lets a payment method refuse orders above a maximum amount, and payment plugins can add their own limits by currency, country or order total. Those rules live in the payment plugin, not in WooCommerce’s settings.
Check: Try the same cart with a lower total or another country. Read the payment plugin’s settings and documentation for limits.
Fix: Adjust the limits in the payment plugin, or offer an alternative method for orders it won’t take.
4. A plugin hides payment methods#
Plugins for conditional payments and for B2B or wholesale stores remove payment methods through woocommerce_available_payment_gateways, by role, country, product or total. If a rule removes the selected method between page load and Place order, the customer gets this message.
Check: Use the Health Check & Troubleshooting plugin to turn off other plugins for your own session and try the same order.
Fix: Change the plugin’s rules, or contact its developer.
5. It appeared under My account > Payment methods#
Deleting a saved card, or making one the default, uses a link that contains a security token. WooCommerce shows this message when that saved method doesn’t belong to the logged-in customer or the token is missing or stale, for example from an old tab or a cached account page.
Check: Reload My account > Payment methods and try the link again.
Fix: If it keeps failing, exclude My account pages from page caching.
Quick reference#
| Cause | How to check | Fix |
|---|---|---|
| No payment method is available at all | Open the checkout as a customer and look at the payment area. Then check WooCommerce > Settings > Payments for methods that are enabled. | Enable a payment method, or finish setting up the one you use and check its own settings page for warnings. |
| The method dropped out after the customer changed something | Repeat the customer's steps: same address, same shipping method, same cart. Watch whether the payment method disappears. | Review the restrictions on that payment method, and offer another method for the cases it excludes. |
| The gateway has a maximum order amount or other limits | Try the same cart with a lower total or another country. Read the payment plugin's settings and documentation for limits. | Adjust the limits in the payment plugin, or offer an alternative method for orders it won't take. |
| A plugin hides payment methods | Use the Health Check & Troubleshooting plugin to turn off other plugins for your own session and try the same order. | Change the plugin's rules, or contact its developer. |
| It appeared under My account > Payment methods | Reload My account > Payment methods and try the link again. | If it keeps failing, exclude My account pages from page caching. |
Reproduced on a test store#
We set up each case below on a clean WooCommerce 11.2.1 store on 6 November 2026 and recorded exactly what it showed.
| What we did | What WooCommerce showed |
|---|---|
| All payment methods disabled under WooCommerce > Settings > Payments. Classic checkout, logged out, a product priced 10. Place the order. | Invalid payment method. |
| Only Cash on delivery enabled, with Enable for shipping methods set to the zone's Local pickup. Zone with Flat rate 5 and Local pickup. Physical product priced 10, Flat rate chosen. Submit the classic checkout (POST to ?wc-ajax=checkout with a valid checkout nonce) with payment_method=cod. | Invalid payment method. |
| Only Cash on delivery enabled, Accept for virtual orders unticked. Cart with one virtual product priced 10. Place the order. | Invalid payment method. |
| Direct bank transfer enabled, plus add_filter( 'woocommerce_available_payment_gateways', function ( $g ) { unset( $g['bacs'] ); return $g; } ). Place the order. | Invalid payment method. |
| All payment methods disabled. Cart total 0 (product priced 0). Place the order. | No message. The order was placed. |
| Checkout block. Send POST /wc/store/v1/checkout with payment_method cod while Cash on delivery is enabled but restricted to Local pickup and the cart uses Flat rate. | Cash on delivery is not available for this order—please choose a different payment method |
For developers#
To see which methods WooCommerce considers available for the current cart, run this on a request with a cart, such as a temporary hook on woocommerce_after_checkout_validation:
error_log( implode( ', ', array_keys( WC()->payment_gateways->get_available_payment_gateways() ) ) );Your own availability rules belong in woocommerce_available_payment_gateways. Payment fields are validated afterwards in the gateway’s validate_fields(), and errors from there use the gateway’s own wording.
Where this lives in WooCommerce 11.2.1:
includes/class-wc-checkout.php,WC_Checkout::validate_checkout: When the cart needs payment, adds the message if the posted payment_method isn’t among get_available_payment_gateways().includes/class-wc-payment-gateways.php,WC_Payment_Gateways::get_available_payment_gateways: Gateways whose is_available() is true, then the woocommerce_available_payment_gateways filter.includes/abstracts/abstract-wc-payment-gateway.php,WC_Payment_Gateway::is_available: The gateway must be enabled and, if it has a maximum amount, the order total must not exceed it. Gateways can add their own rules.includes/gateways/cod/class-wc-gateway-cod.php,WC_Gateway_COD::is_available: Example of a gateway rule: Enable for shipping methods and Accept for virtual orders.includes/class-wc-form-handler.php,WC_Form_Handler::pay_action: The Pay for order form: message when no method is posted or it isn’t available.includes/class-wc-form-handler.php,WC_Form_Handler::delete_payment_method_action: My account > Payment methods: message when the saved method doesn’t belong to the user or the link’s nonce is invalid (same in set_default_payment_method_action).src/StoreApi/Routes/V1/Checkout.php,Checkout::get_request_payment_method: The block checkout’s wording for a method that isn’t available.
Related WooCommerce errors#
- We were unable to process your order, please try again.
- Please read and accept the terms and conditions to proceed with your order.
- This order’s status is “Cancelled”—it cannot be paid for. Please contact us if you need assistance.
Back to the WooCommerce error reference.
Frequently asked questions#
Why does the checkout say there are no available payment methods?
Every enabled payment method declined this order, or none is enabled. Check WooCommerce > Settings > Payments and each method’s own restrictions.
Why does Cash on delivery disappear for some orders?
It can be limited to certain shipping methods with Enable for shipping methods, and to physical orders by unticking Accept for virtual orders. Changing either side removes it.
Does this mean the customer's card was declined?
No. A declined card produces the payment provider’s own message. This one appears before any payment is attempted.
Why don't free orders ask for a payment method?
When the total is zero, WooCommerce skips the payment check and completes the order without a payment method.
What does "is not available for this order—please choose a different payment method" mean?
It is the checkout block’s wording for the same check, and it names the method that was refused.