Items & Catalog Management Group multiple items together to create complex product offerings with customizable selection rules and organized categories. Key Benefits# Complex Product Offerings - Combine multiple items into structured bundles with flexible selection options
Organized Categories - Group bundle options into logical categories like "Drinks", "Sides", or "Packaging"
Flexible Selection Rules - Control minimum/maximum selections, optional vs required categories, and pricing models
Bundle Configuration# Bundle Categories - Logical groupings that organize related bundle options (e.g., "Beverages", "Add-ons", "Upgrades")Is Selectable - Whether customers can choose options or all are automatically included
Min/Max Selections - Control how many options customers must or can select
Is Optional - Whether the entire category is required or optional
Ordering - Display sequence of categories
Bundle Options - Individual items within each category that customers can selectAdditional Pricing - Extra cost on top of main item price (or $0 for included options)
Stock Management - Individual inventory tracking for each option
Optional Override - Make specific options optional even in required categories
Usage Limits - Set quantity or usage restrictions for SaaS services
How It Works# Main item serves as the bundle foundation with base pricing
Categories organize related options into logical groups
Customers select from available options based on defined rules
Additional pricing is calculated automatically for premium options
Bundle selections are validated against minimum/maximum requirements
Customer Usage# Common Use Cases: Meal customization (main dish + sides + drinks), service packages (base plan + add-ons), product bundles (main item + accessories), subscription tiers with different feature sets.Browse Bundle Options# Display organized categories with available selections, pricing, and selection rules to guide customer choices. Process customer selections with validation against category rules and calculate final pricing with any additional costs. Configure bundles using Update Item with bundle_categories field Then in the Checkout Flow , select options by passing bundle_categories {
....
"bundle_categories" : [
{
"id" : <category_id>,
"options" : [
{
"item_id" : <item ID>,
"qty" : <Quantity>
}
]
}
]
} Merchant Integration# For bundle category and option management operations, see the Item Bundles documentation. Modified at 2025-09-21 08:27:06
