Shopify Subscription Error Code Guide
Exact causes and step-by-step fixes for Shopify subscription billing error codes.
PAYMENT_PROVIDER_IS_NOT_ENABLED
PAYMENT_PROVIDER_IS_NOT_ENABLED: Shopify Fix
PAYMENT_PROVIDER_IS_NOT_ENABLED is a Shopify SubscriptionBillingAttemptErrorCode. Here is the exact cause and step-by-step fix for subscription merchants.
SHOP_PAY_PAYMENT_METHOD_REVOKED
Shop Pay Payment Method Revoked: Subscription Fix
Shop Pay payment method revoked causes silent Recharge subscription failures. Here is why it happens and the exact steps to recover affected subscriptions.
CARD_DECLINED
CARD_DECLINED: Shopify Subscription Fix
CARD_DECLINED is a Shopify SubscriptionBillingAttemptErrorCode mapping to Stripe's card_declined. Here is the cause, retry strategy, and recovery steps.
INSUFFICIENT_FUNDS
INSUFFICIENT_FUNDS: Shopify Retry Guide
INSUFFICIENT_FUNDS on a Shopify subscription is a temporary decline. Here is the optimal retry timing, dunning configuration, and customer communication approach.
AUTHENTICATION_REQUIRED
AUTHENTICATION_REQUIRED: Shopify 3DS Fix
AUTHENTICATION_REQUIRED on a Shopify subscription means 3DS is blocking the renewal. Here is the MIT exemption fix and how to recover affected subscriptions.
EXPIRED_CARD
EXPIRED_CARD: Shopify Renewal Recovery
EXPIRED_CARD on a Shopify subscription renewal means the stored card is permanently invalid. Here is how to recover revenue and prevent future expiration failures.
DO_NOT_HONOR
DO_NOT_HONOR: Shopify Subscription Fix
DO_NOT_HONOR is a Stripe catch-all bank refusal on Shopify subscription renewals. Here is what it means, retry strategy, and when to escalate to the customer.
MAX_RETRIES_REACHED
MAX_RETRIES_REACHED: Recharge Next Steps
Recharge MAX_RETRIES_REACHED means dunning is exhausted. Here is what happens to the Shopify contract, how to detect ghost subscriptions, and how to recover.
SUBSCRIPTION_CONTRACT_PAUSED
SUBSCRIPTION_CONTRACT_PAUSED: Shopify Fix
A PAUSED Shopify subscription contract stops billing but may still show active in Recharge. Here is how to detect, diagnose, and resolve the state mismatch.
subscription_payment_intent_requires_action
invoice.payment_action_required: Shopify Fix
Stripe fires invoice.payment_action_required when a subscription renewal requires 3DS. Here is how to handle the webhook and send the authentication link to customers.
card_velocity_limit_exceeded
card_velocity_limit_exceeded: Stripe Subscription Fix
Stripe returns card_velocity_limit_exceeded when an issuer blocks a charge for exceeding spending frequency or amount limits. Here is why it happens on subscriptions and exactly how to recover it.
lost_card
lost_card: Stripe Subscription Decline Fix
Stripe's lost_card decline code means the card issuer has flagged the card as lost. Here is what this means for your Shopify subscription, why retrying is dangerous, and the only correct recovery path.
stolen_card
stolen_card: Stripe Subscription Decline Fix
Stripe's stolen_card decline means the issuer has flagged the card as stolen. Retrying is harmful. Here is the exact response protocol to protect your Shopify store and recover the subscription.
SUBSCRIPTION_SKIPPED
SUBSCRIPTION_SKIPPED: Recharge Subscription Skip Fix
A Recharge subscription skipped in Shopify means a billing cycle was intentionally or accidentally bypassed. Here is how to detect it, why it happens, and how to recover missed revenue.
BILLING_ATTEMPT_FAILED_NO_ERRORCODE
Shopify Billing Attempt Failed With No errorCode
When a Shopify subscriptionBillingAttempt returns ready: false with a null or missing errorCode, the cause is usually a transient gateway issue or an uncaught internal Shopify error. Here is how to diagnose and recover.
unexpected_state
unexpected_state: Stripe PaymentIntent Fix
Stripe's unexpected_state error on a PaymentIntent means an operation was attempted on a PaymentIntent that is in an incompatible status. Here is how this affects Shopify subscriptions and how to resolve it.
CUSTOMER_PAYMENT_METHOD_INVALID
CUSTOMER_PAYMENT_METHOD_INVALID: Shopify Subscription Fix
CUSTOMER_PAYMENT_METHOD_INVALID is a Shopify SubscriptionBillingAttemptErrorCode indicating the stored payment method cannot be used. Here is exactly what causes it and the steps to recover the subscription.
CHARGE_FAILED_ORDER_MISSING
Recharge Charge Succeeded But Shopify Order Missing
When a Recharge subscription charge succeeds in Stripe but no Shopify order is created, you have a revenue-collected-without-fulfillment mismatch. Here is the exact cause and the recovery steps.
setup_intent_authentication_failure
setup_intent_authentication_failure: Stripe Fix
Stripe returns setup_intent_authentication_failure when a 3DS authentication fails during SetupIntent creation for a subscription. Here is why this breaks future recurring charges and how to recover.
SUBSCRIPTION_CONTRACT_TERMINATED
SUBSCRIPTION_CONTRACT_TERMINATED: Shopify Fix
A Shopify subscription contract with status TERMINATED means the contract has been permanently ended by either Shopify or the merchant. Here is what causes termination, how to detect it, and whether revenue recovery is possible.
insufficient_funds
insufficient_funds: Stripe Subscription Fix
insufficient_funds on a Stripe subscription means the bank approved the card but the balance was too low at renewal time, and this page explains the best retry timing and recovery steps.
generic_decline
generic_decline: Stripe Subscription Fix
generic_decline on a Stripe subscription is a catch-all issuer refusal, and this page covers why merchants cannot diagnose it directly and how to recover safely.
pickup_card
pickup_card: Stripe Subscription Fix
pickup_card on a Stripe subscription indicates a severe issuer fraud flag, and this page explains why the card must be treated as permanently unusable.
incorrect_cvc
incorrect_cvc: Stripe Subscription Fix
incorrect_cvc on a Stripe subscription points to a CVV mismatch during card setup, and this page explains why it is an onboarding problem rather than a renewal issue.
incorrect_number
incorrect_number: Stripe Subscription Fix
incorrect_number on a Stripe subscription means the primary account number was entered incorrectly during setup, and this page covers the exact recovery path.
currency_not_supported
currency_not_supported: Stripe Subscription Fix
currency_not_supported on a Stripe subscription means the issuer or card network does not support billing in that currency, and this page explains the best merchant response.
card_not_supported
card_not_supported: Stripe Subscription Fix
card_not_supported on a Stripe subscription means the card product is not permitted for that recurring billing setup, and this page explains how merchant settings often cause it.
duplicate_transaction
duplicate_transaction: Stripe Subscription Fix
duplicate_transaction on a Stripe subscription usually means your billing flow tried to create the same charge twice, and this page explains how to stop the double-charge pattern.
fraudulent
fraudulent: Stripe Subscription Fix
fraudulent on a Stripe subscription means Stripe's own risk systems blocked the charge as high risk, and this page covers the correct no-retry response.
BILLING_CYCLE_ERROR
BILLING_CYCLE_ERROR: Shopify Subscription Fix
BILLING_CYCLE_ERROR on a Shopify subscription usually points to contract cycle misconfiguration, and this page explains how bad billing anchors or intervals break recurring charges.
WEBHOOK_DELIVERY_FAILED
WEBHOOK_DELIVERY_FAILED: Recharge Subscription Fix
WEBHOOK_DELIVERY_FAILED in a Recharge subscription flow means Recharge could not deliver a required webhook to Shopify or your integration, and this page explains the resulting state mismatch.
PAYMENT_METHOD_NOT_SUPPORTED
PAYMENT_METHOD_NOT_SUPPORTED: Shopify Subscription Fix
PAYMENT_METHOD_NOT_SUPPORTED on a Shopify subscription means the payment method type cannot be used for recurring billing, and this page explains what merchants must change.
account_closed
account_closed: Stripe Subscription Fix
account_closed on a Stripe subscription means the underlying account has been permanently shut down, and this page explains why retries should stop immediately.
testmode_charges_only
testmode_charges_only: Stripe Subscription Fix
testmode_charges_only on a Stripe subscription means production traffic is hitting a test-mode API path, and this page explains how mixed keys break live billing.
CONTRACT_CANCELLED_UNEXPECTEDLY
CONTRACT_CANCELLED_UNEXPECTEDLY: Shopify Subscription Fix
CONTRACT_CANCELLED_UNEXPECTEDLY on a Shopify subscription means the contract was cancelled when the intended behavior was to pause it, and this page explains how to recover the customer safely.
do_not_honor_bank_retry
do_not_honor After Retries: Stripe Subscription Fix
When Stripe returns do_not_honor repeatedly across multiple retry attempts, the issuer has a persistent block. Here is how to distinguish a retry-sensitive block from a permanent one and when to stop.
DUNNING_CANCELLED_ACTIVE_SHOPIFY
Recharge Dunning Cancelled Subscription but Shopify Shows Active
When Recharge dunning cancels a subscription after max retries but Shopify still shows it as active, you have a ghost subscription. Here is how to detect it, stop the bleed, and prevent recurrence.
BILLING_DATE_IN_PAST
Shopify Subscription Next Billing Date in the Past
When a Shopify subscription contract's nextBillingDate is in the past, all billing attempts fail silently. Here is how to detect stale billing dates across your subscription base and batch-correct them.
RECHARGE_API_RATE_LIMIT
Recharge API Rate Limit During Subscription Billing
Recharge enforces API rate limits that can cause subscription billing operations to fail during high-volume windows. Here is how rate limiting affects billing and how to handle it correctly.
STRIPE_WEBHOOK_SIGNATURE_INVALID
Stripe Webhook Signature Invalid: Subscription Event Fix
Stripe webhook signature validation failures mean your endpoint is receiving events it cannot verify, causing subscription state updates to be rejected. Here is the cause and fix.
SHOPIFY_BILLING_ATTEMPT_TIMEOUT
Shopify Subscription Billing Attempt Timeout
Shopify subscription billing attempts that do not resolve within the expected window leave subscriptions in an ambiguous state. Here is how to handle pending billing attempts and prevent revenue loss.
SHOPIFY_ORDER_CREATION_FAILED
Shopify Subscription Order Not Created After Successful Payment
When a Shopify subscription billing attempt succeeds but no order is created, you have collected revenue without fulfillment capability. Here is the exact reconciliation path.
RECHARGE_CHARGE_PENDING_TIMEOUT
Recharge Charge Stuck in Pending State
A Recharge subscription charge that stays in PENDING status without resolving to SUCCESS or ERROR indicates a processing hang. Here is how to detect it, recover the charge, and prevent recurrence.
SHOPIFY_CUSTOMER_NOT_FOUND
Shopify Subscription Customer Not Found Error
When a Shopify subscription billing attempt fails because the customer record cannot be found, it typically means the customer was deleted or merged. Here is how to recover the subscription.
STRIPE_PAYMENT_METHOD_DETACHED
Stripe PaymentMethod Detached from Customer
When the Stripe PaymentMethod linked to a subscription is detached from the customer, all future renewals fail immediately. Here is how this happens and how to restore billing.
SHOPIFY_VARIANT_UNAVAILABLE
Shopify Subscription Variant Unavailable or Archived
When the product variant in a Shopify subscription contract is archived or unavailable, the subscription cannot generate orders. Here is how to detect affected subscriptions and update them without losing the customer.
STRIPE_3DS_ABANDONED
Stripe 3DS Authentication Abandoned by Customer
When a customer abandons the 3DS authentication flow for a Shopify subscription renewal, the PaymentIntent expires and billing fails. Here is how to recover abandoned authentications without losing the subscriber.
RECHARGE_SUBSCRIPTION_PAUSED_BILLING_ATTEMPTED
Recharge Billing Attempted on Paused Subscription
When Recharge attempts to bill a subscription that is in PAUSED state, it indicates a resume logic error or a state sync issue. Here is how to diagnose it and prevent unwanted charges.
STRIPE_PAYMENT_INTENT_ALREADY_CONFIRMED
Stripe PaymentIntent Already Confirmed Error
Attempting to confirm a Stripe PaymentIntent that has already been confirmed causes this error. Here is why it happens in subscription billing and how to fix the double-confirmation bug.
STRIPE_DISPUTE_SUBSCRIPTION_CHARGE
Stripe Dispute on Subscription Charge: Merchant Response Guide
A Stripe dispute on a subscription charge means the customer asked their bank to reverse the payment. Here is how to respond, what evidence wins disputes, and how to prevent future chargebacks on subscriptions.