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.
- CustomerChecks outChooses a plan and pays the first order
- ShopifyVaults the methodThe card never reaches the app
- Your storeContract createdA Shopify object you own
- ShopifyBills on scheduleA billing attempt each cycle
- Your storeOrder createdFulfilled like any other
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.
Authentication happens at checkout. In Europe, Strong Customer Authentication means the first payment is authenticated — and that authentication is what lets later renewals go through without the customer present. Shopify’s checkout handles it, which is one good reason to keep subscriptions on Shopify checkout rather than a custom flow. SCA and subscriptions.
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?
- Selling into Europe: did the first payment complete authentication?
- 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 the guide to How to Add Subscriptions to Your Shopify Store.