Invalid payment method invalid_payment_method
What this decline means
The stored payment method attached to the subscription is no longer usable — Shopify's own guidance for this code is to update it or create a new one. The vaulted record itself is the problem, not the balance behind it.
Why it happens on subscription renewals
- The customer removed or replaced the payment method in their account, leaving the subscription pointing at a dead record.
- The vaulted card was invalidated upstream — account closed, card product discontinued, or the token revoked by the issuer or wallet.
- A migration or app change left the subscription referencing a payment method that no longer resolves.
The merchant playbook
- Don't retry — the charge isn't being declined on its merits; it can't properly run at all until the stored method is replaced.
- Send the customer a payment-method update link immediately; this code's only exit is a new or re-saved method on the subscription.
- Check whether the subscriber has another valid method on file — some setups can switch the subscription to it directly, which beats asking the customer to act.
- Audit after fixing: if several subscriptions show this code around the same date, something systemic (an app change, a migration) invalidated records in bulk.
Should you retry?
No. Until the subscription points at a live payment method, retries fail identically. Fix the record, then bill.
Common questions
How is this different from an expired card?
An expired card still exists but is out of date; an invalid payment method means the stored record itself no longer works — removed, revoked, or orphaned. Both end in the same place: the customer saving a usable method.
Can the merchant fix this without the customer?
Only if another valid payment method already exists on the customer's account and your subscription app allows switching the contract to it. Otherwise the customer has to act.
Related codes: expired_card · payment_method_declined · incorrect_number · or see the
full decline-code guide.
Where Moorly fits: Moorly reads the decline reason behind every failed renewal in your existing subscription app and applies the playbook above automatically — the right treatment per code, with a dollar figure on what each failure family costs your store. It starts read-only. Join the early-access list →
Moorly is an independent product by Velun Labs and is not affiliated with Shopify, Appstle Inc., or Seal Subscriptions s.r.o. Code names follow Shopify's public API documentation as of August 2026; bank behavior varies by issuer — always confirm against your own admin.