Shopify Subscription Customer Not Found Error
Root cause
The Shopify customer ID linked to the subscription contract no longer exists — the customer account was deleted, merged with another account, or anonymized (GDPR deletion), leaving the subscription contract referencing an invalid customer ID.
Symptoms
- • Shopify subscriptionBillingAttemptCreate returns a customer not found error
- • The subscriptionContract query returns a null or empty customer field
- • Recharge still shows the subscription ACTIVE with a valid customer record
- • The customer cannot log into their Shopify account using their original email
How to fix it
Determine whether the customer was deleted or merged
In Shopify Admin, search for the customer by email. If the record does not exist, the account was deleted or anonymized. If a record exists under a different ID (merged accounts), the subscription contract is still linked to the old ID. Check the Shopify customer event log for deletion or merge events. Contact Shopify Support if you cannot determine the cause.
Open in admin →For merged customers: update the subscription contract with the new customer ID
If the customer was merged into another account, find the new Shopify customer ID. Use the subscriptionContractUpdate mutation to update the contract's customerId to the new ID. Once updated, verify the subscription contract is still valid and retry billing with subscriptionBillingAttemptCreate.
For deleted customers: cancel the subscription and contact the customer
If the customer account was permanently deleted, the subscription contract cannot be associated with a valid customer. Cancel the subscription in both Recharge and Shopify. If the deletion was unintentional (admin error), recreate the customer account, then create a new subscription contract linked to the new account — the customer must re-authorize billing.
Frequently asked questions
Can a Shopify customer deletion cascade to cancel their subscriptions automatically?
No. Deleting a Shopify customer account does not automatically cancel their subscription contracts. The contracts remain in place with an invalid customer reference, causing all future billing attempts to fail silently. Always cancel subscription contracts before deleting a customer account — or use Recharge's customer deletion flow which handles this cleanup.
How does GDPR deletion affect active Shopify subscriptions?
GDPR deletion requests anonymize the customer's personal data but the subscription contract may still exist with an anonymized customer ID. Billing attempts will fail because the anonymized customer cannot authorize new charges. Your GDPR deletion workflow must include cancellation of all active subscription contracts before or alongside the data anonymization.
Detect this error automatically
Free cross-stack scan finds all billing errors in 60 seconds.
Run Free Scan →