How Subscription Checkout Works on Shopify
What happens between a customer selecting a plan and a subscription contract existing — and the checkout details that quietly cost you signups.
Subscription checkout on Shopify looks like normal checkout with one extra consequence: at the end of it, the customer’s payment method is vaulted for future use and a subscription contract is created.
Understanding the sequence helps when something goes wrong, because the failure points are specific.
The sequence
- Customer selects a selling plan on the product page. The line item carries the plan id into the cart.
- Checkout recognises a subscription line item and requires a payment method that supports future charges. This is why some payment options disappear on a subscription checkout — they cannot be vaulted.
- Customer completes checkout. The first payment is taken like any other order.
- Shopify vaults the payment method against the customer.
- A subscription contract is created, referencing the vaulted method, the line items, the address and the schedule.
- Your app receives a webhook and starts tracking the contract.
Where it breaks
Payment methods that cannot be vaulted disappear. A customer who always pays with a method that does not support recurring charges will find their usual option missing, with no explanation. Some abandon. If your analytics show subscription checkouts abandoning at the payment step specifically, this is the first thing to check.
Mandate registration is a separate step in some markets. In India, vaulting is not enough — there has to be a registered e-mandate. If that registration fails while the order succeeds, you have a customer who believes they subscribed and a system with nothing to charge. This is the most damaging silent failure in Indian subscription setups. Detail.
Mixed carts confuse people. A cart containing a subscription item and a one-time item is valid, but the customer may not understand which part recurs. Label the line item clearly in cart and at checkout — “Delivers every 4 weeks” next to the product name.
Discount codes interact awkwardly. A percentage code stacking on top of a subscription discount can produce a price you did not intend, and depending on configuration it may apply to every future delivery rather than the first. Decide deliberately whether codes apply to subscription line items at all.
What to check before launch
Place a real subscription order on your live store with a real payment method:
- Does the subscription line item read clearly in cart and checkout?
- Does the confirmation email say when the next charge happens?
- Does a contract appear in your admin?
- In India: did a mandate register, and did the confirmation reflect that?
- Let it renew. Most subscription bugs appear at the second charge, not the first.
That last one is the test most merchants skip, and it is the one that matters. The first order is an ordinary order and almost always works. The second is where the subscription machinery is actually exercised.
Post-purchase
The order confirmation is your best chance to set expectations:
- When the next delivery arrives
- How much it will cost
- Where to manage it
- How to skip or cancel
A customer who knows all four is dramatically less likely to open a support ticket, dispute a charge, or cancel out of uncertainty. Subscription onboarding emails.
Part of our guide to How to Add Subscriptions to Your Shopify Store.