CUSTOMER_PAYMENT_METHOD_INVALID: Shopify Subscription Fix
Root cause
The customer's stored payment method token in Shopify is no longer valid. This happens when a card expires and is not updated, when a customer revokes the Shopify Billing authorization, when Shop Pay deactivates the stored payment token, or when the payment method was created under a different Shopify billing context and is no longer recognized.
Symptoms
- • Shopify subscriptionBillingAttempt returns errorCode: CUSTOMER_PAYMENT_METHOD_INVALID
- • Recharge shows the subscription ACTIVE with no charge errors
- • The customer's payment method appears valid in Shopify Admin but the billing token is expired or revoked
- • All subsequent billing attempts for this subscription return the same error
- • No Stripe charge is attempted — the error occurs before the charge reaches the gateway
How to fix it
Identify the invalid payment method in Shopify Admin
In Shopify Admin, open the customer record and go to Payment Methods. The stored payment method linked to the subscription will appear here. Check whether it shows as expired, revoked, or unverified. If the payment method appears valid in the UI but billing fails, the underlying token may have been invalidated by the gateway without a UI update.
Open in admin →Send a payment method update request to the customer
Email the customer a link to update their payment method in their Shopify customer account or Recharge customer portal. Use Recharge's built-in payment update email or send a manual email with a direct link. Include a deadline: 'Your subscription will be paused in 7 days if payment is not updated.'
Update the subscription contract with the new payment method
Once the customer adds a new payment method, update the Shopify subscription contract to reference the new customerPaymentMethodId using the subscriptionContractUpdate mutation. After updating, create a new subscriptionBillingAttemptCreate to recover the missed payment. Do not wait for the next scheduled cycle — recover the missed revenue immediately.
Frequently asked questions
How is CUSTOMER_PAYMENT_METHOD_INVALID different from PAYMENT_METHOD_REVOKED?
PAYMENT_METHOD_REVOKED specifically indicates the customer revoked Shopify's billing authorization — a deliberate customer action. CUSTOMER_PAYMENT_METHOD_INVALID is broader: it covers expired cards, invalid tokens, and any state where the stored payment method cannot be used, regardless of the cause.
Will updating the customer's card in Shopify Admin fix this automatically?
No. Updating the card in the customer UI does not automatically update the payment method linked to the subscription contract. You must explicitly update the subscription contract using the subscriptionContractUpdate mutation with the new customerPaymentMethodId before retrying billing.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →