Introduction
Shopify has introduced support for subscription selling plans within Shopify POS, enhancing the checkout process for merchants. Learn about the new updates and how you can use these APIs effectively.
New Cart API Methods
Adding Selling Plans
To add a selling plan to a line item in the cart, use the following method:
shopify.cart.addLineItemSellingPlan({ lineItemUuid: 'line-item-uuid', sellingPlanId: 123456, sellingPlanName: 'Monthly Subscription - 10% off' });Removing Selling Plans
To remove a selling plan from a line item, use this method:
shopify.cart.removeLineItemSellingPlan('line-item-uuid');Enhanced Line Item Interface
The LineItem interface has been enhanced to support selling plans. Here’s a brief overview of its updated structure:
- Uuid: Unique identifier for the line item.
- ProductId: ID of the product associated with the line item.
- RequiresSellingPlan: Indicates if a product must have a selling plan.
- HasSellingPlanGroups: Indicates if a product has available selling plans.
- SellingPlan: The currently applied selling plan.
Version Requirements
Critical Compatibility Note: To utilize these features, your system must meet the following version requirements:
- POS UI Extension Version: 2025-10 or later.
- Shopify POS Version: 10.13 or later.
Using selling plan APIs or fields in older versions will result in blocked checkouts. Ensure your Shopify POS is updated to avoid disruptions.