Why Did My Recharge Subscription Fail to Renew in Shopify? (Complete Fix Guide)
When a Recharge subscription fails to renew in Shopify, the root cause is almost always one of four things: the Shopify payment gateway is not enabled for recurring billing (errorCode: PAYMENT_PROVIDER_IS_NOT_ENABLED), the customer's Shop Pay authorization was revoked, Recharge hit max retries but never synced the cancellation to Shopify, or a webhook delivery failure left the systems in conflicting states. Here is how to diagnose each one.
What does it mean when a Recharge subscription fails to renew?
A failed renewal means one system recorded a failure but the other systems may not know about it. Shopify may show a billing attempt with an errorCode while Recharge still shows the subscription as ACTIVE. This is the most common and most expensive type of cross-stack mismatch.
The result: the customer is still being served (Shopify sees an active contract) but no payment is being collected. Revenue leaks silently with no alert in any dashboard.
What is the PAYMENT_PROVIDER_IS_NOT_ENABLED error in Shopify?
PAYMENT_PROVIDER_IS_NOT_ENABLED is a SubscriptionBillingAttemptErrorCode returned when Shopify cannot route a recurring charge to the configured payment gateway.
Common triggers: switching from Shopify Payments to a third-party gateway without updating subscription contracts, gateway maintenance windows, or a misconfigured recurring billing setting on the gateway.
The Recharge side will show no error — it only sees that the Shopify billing attempt was scheduled. The mismatch is between Shopify's billing attempt errorCode and Recharge's subscription status of ACTIVE.
What happens after Recharge hits max retries on a failed charge?
Recharge retries failed charges according to your configured dunning schedule — typically up to 8 attempts. When all retries are exhausted, Recharge fires the charge/max_retries_reached webhook and cancels the subscription on its side.
The critical bug: if the Shopify subscription contract is not updated to reflect the cancellation, you now have a ghost subscription. Shopify shows ACTIVE, Recharge shows CANCELLED. The customer may continue to receive service while no payment is collected.
How do you diagnose which layer caused the subscription failure?
Start with the Shopify billing attempt. In Shopify Admin > Subscriptions, find the contract and check the most recent billing attempt for an errorCode. If errorCode is present, the failure originated in Shopify's payment routing layer.
If no Shopify errorCode exists, check Recharge. In Recharge Admin > Charges, filter by status=ERROR and look at the error_type field. PAYMENT_METHOD_REVOKED means Shop Pay authorization was revoked. MAX_RETRIES means dunning exhausted.
If neither platform shows an error, the failure is likely a webhook delivery failure. Check your Shopify webhook delivery log for failed deliveries to your subscription app endpoint.
Frequently asked questions
Can a Recharge subscription appear active while no payments are being collected?
Yes. If Shopify billing attempts fail silently and Recharge does not receive a state change notification, the subscription shows ACTIVE in Recharge indefinitely. This is the most common source of undetected revenue leakage for Shopify subscription merchants.
How long before Recharge cancels a subscription after failed payments?
Recharge cancels after exhausting its configured retry schedule, typically 8 attempts spread over 7-14 days depending on your dunning settings. Until then, the subscription remains in ERROR state and revenue is at risk.
Does Shopify send an alert when a subscription billing attempt fails?
No. Shopify does not send merchant-facing alerts for individual billing attempt failures. The errorCode is only visible in the Admin API or subscription contract UI. This is why cross-stack monitoring is necessary to detect failures in real time.
What is the fastest way to find all failing Shopify subscription billing attempts?
Query the Shopify Admin GraphQL API for subscriptionBillingAttempts filtered by errorCode. Alternatively, the AltorLab free scanner automates this cross-stack check and shows you all mismatches with estimated revenue impact in 60 seconds.
Can I fix a PAYMENT_PROVIDER_IS_NOT_ENABLED error without cancelling the subscription?
Yes. Re-enable the payment gateway for recurring billing in Shopify Payments settings, then manually trigger a new billing attempt on the subscription contract. The subscription remains active and the customer is not affected.