PAYMENT_METHOD_NOT_SUPPORTED: Shopify Subscription Fix
Root cause
Shopify returns PAYMENT_METHOD_NOT_SUPPORTED when the customer selected a payment method type that Shopify cannot use for subscription contracts, such as a wallet or local method that does not support recurring off-session charges.
Symptoms
- • Subscription creation or update fails even though the customer can pay one-time orders
- • Shopify rejects the billing method before a normal recurring charge is attempted
- • Wallet-based or alternative payment methods fail more often than standard cards
- • Support sees a method-level compatibility error rather than a bank decline
How to fix it
Identify the unsupported payment method
Check the customer payment method attached to the contract or checkout session and determine exactly which type was selected. Compare it to Shopify's supported recurring payment method list for your store setup. This tells you whether the issue is product-level incompatibility or a misconfigured checkout option.
Open in admin →Switch the customer to a card
Ask the customer to update the subscription to a supported credit or debit card that can be stored for off-session recurring billing. If they originally used a one-time-friendly wallet, explain that subscriptions require a reusable payment credential. Make the replacement flow as direct as possible to reduce abandonment.
Hide unsupported methods from subscription checkout
Update your storefront or subscription app configuration so unsupported payment methods are not offered during subscription purchase flows. This prevents customers from selecting a method that can never be attached to a contract. Merchants with mixed one-time and subscription carts should clearly separate supported recurring methods in the UI.
Frequently asked questions
Why can a payment method work for one-time checkout but not for subscriptions?
Because subscriptions need a reusable credential that Shopify can store and charge off-session later. Some wallets and local methods support immediate one-time payment authorization but do not permit merchant-initiated recurring charges afterward. The customer experience looks inconsistent unless the storefront clearly distinguishes one-time payment options from subscription-compatible methods.
Can merchants fix PAYMENT_METHOD_NOT_SUPPORTED without changing the customer's method?
Usually no for the affected contract. If the chosen method type itself does not support recurring billing, the contract needs a different credential. The preventive fix is on the merchant side: remove unsupported options from subscription flows and make sure the billing UI steers customers toward methods Shopify can store for future automatic charges.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →