Preorders API

Before diving into the API reference, it's important to understand the key term we use - Selling Plans

What are Selling Plans?

Selling Plans in the context of preorders are configurations that define how a preorder product is sold, billed, and delivered to customers.

Core Purpose:

  • Enable merchants to sell products before they're in stock or available for immediate shipping

  • Define payment schedules, delivery timelines, and inventory management for preordered items

  • Provide customization options for how preorders appear and function in the storefront

What data is present in a Selling Plan?

  • Basic Information: Name, internal reference name, enabled status

  • Billing Configuration: When and how much to charge (at checkout or later), charge types (percentage or fixed amount)

  • Delivery Settings: When products will be delivered (exact date or interval after purchase)

  • Inventory Management: How inventory is reserved and which system manages it

  • Pricing Options: Discount amounts or percentages for preordered items

  • UI Customization: Button text, badge styling, shipping information text

Variant Association:

  • Selling plans can be associated with product variants in three ways:

    • All products in the store

    • Products in a specific collection

    • Custom selection of individual variants

  • Each variant can have custom settings like shipping text and maximum preorder quantity

Multi-Market Support:

  • Selling plans can be configured for specific markets in multi-market stores

  • Different markets may have different preorder terms or availability

Last updated