About custom purchase options

A purchase option determines how customers can buy products from a store. Purchase options can help merchants manage cash flow and inventory, have flexibility on product launches, and diversify marketing strategies.

Purchase options include subscriptions and deferred purchase options.

Subscriptions enable customers to purchase products on a recurring basis. For example, customers can do the following:

• Pay-per-delivery subscription: Pay for products for each delivery. New orders are created at regular intervals. This option is also known as "Subscribe and save".
• Pre-paid subscription: Make a single payment upfront and receive products on a regular cadence until the order is fulfilled.

For more information, refer to Subscriptions.

Pre-order and TBYB enable customers to purchase products with deferred payments or deliveries. For example, customers can do the following:

• Pre-order: Place an order for products or variants that haven't been released yet.
• Try before you buy: Try products before completing payment, and send back the products that aren't wanted.

You can enable deposits for pre-order and TBYB. Shopify will store a customer's payment method so that merchants can collect the remaining balance amount without contacting the customer.

For more information, refer to Pre-order and Try Before You Buy (TBYB) apps.

A purchase option defines how a product can be sold and specifies selling plan policies around pricing, delivery, and more.

For example, a subscription can include "Delivery every week, 15% off" and "Delivered every two weeks, 10% off" selling plans.

Selling plans include configurations of the following policies:

• Pricing: Defines pricing changes on a given product variant.
• Billing: Defines the intervals of time between the placement of an order and payment collection.
• Delivery: Defines when the order should be fulfilled, from the time that the order is created to the time that it leaves the merchant's possession.
• Inventory: Defines whether the inventory is committed when the order is created or when the order is fulfilled.

• You can create subscriptions by configuring pricing, delivery, and billing policies.
• You can create deferred purchase options by configuring pricing, inventory, delivery, and billing policies.

For more information, refer to Subscriptions and Deferred purchase options.

The following diagram illustrates the GraphQL Admin API objects for purchase options:

• The SellingPlanGroup object includes one or more SellingPlan objects.
• The SellingPlan object specifies how a product can be sold, such as "Weekly delivery" or "Monthly delivery". Policies are organized into SellingPlan.
• Each SellingPlanGroup includes products (Product), product variants (ProductVariant), and policy configurations (SellingPlan).

The category field represents the selling plan category that's used to filter orders by selling plan category on the order page. The category field supports the following approved categories:

• SUBSCRIPTION
• PRE_ORDER
• TRY_BEFORE_YOU_BUY

If you want to offer a category that isn't listed above, then set the category field to OTHER, and fill out our request form, where we'll review your request for a new selling plan category.

The following are our principles for extending the Shopify platform to support purchase options.

Purchase option apps provide merchants and customers with various ways to sell and buy products, beyond the "buy now, pay now, and ship now" experience.

Checkout determines charge amounts, payment terms, and payment and shipping methods. Checkout needs to be accurate and have the highest standards of performance and reliability at global scale.

Ensuring that merchants are using Shopify’s checkout guarantees performance and integration with Shopify’s core feature set and ecosystem of apps. As Shopify and its ecosystem evolve, checkout is crucial to ensure a sustainable long-term journey for merchants.

To maximize merchant success, Shopify models and stores business operational data related to purchase options. A centralized location for key purchase option business data can help merchants mitigate integrity risks and reduce synchronization costs.

Both Shopify and apps should be able to access the purchase option business data to help merchants understand and grow their business. The following are examples of purchase option business data:

• What purchase options are offered
• Who the purchase options customers are
• What products customers buy using purchase options
• How customers are paying for their purchase option orders
• How purchase option data changes over time

Merchants can use purchase options in various ways depending on the industry, product type (physical or digital), and business size. Shopify’s role is to create a platform where developers can provide creative solutions for merchants to effectively manage their purchase options.

To use the GraphQL Admin API for purchase options, your app needs to request the following access scopes:

To help you build and manage purchase options, Shopify offers the following developer tools and resources.

For information on UX guidelines, refer to the following resources:

• Subscription UX guidelines
• Pre-orders and try before you buy UX guidelines

• Learn about subscriptions
• Learn about deferred purchase options