The Bundle API
Bundles allow for linking products together and to sell them as one unit. The bundle itself can be considered a product as well, and most API endpoints that operate on products can operate on bundles. When a user is given access to a bundle, they will automtically gain access to all the contained products.
When products are added to bundles, they are referred to by the API as bundle items.
There are three pricing options for bundles
Set one price for the bundle as a whole
Set individual prices on items in the context of the bundle (does not change the price of these products when sold separately). The total price of the bundle will be the sum of the price of each bundle item.
By omitting price for both the bundle and its items, a price will be automatically calculated based on the standard prices for every bundle item.
hide_items flag on bundles, you control whether or not individual bundle items are displayed to the user on the product overview, when purchasing, in receipts etc. When showing items, their display order may be controlled with the bundle items'
Bundles are dynamic by default, meaning that future changes to the bundle will affect all users, including those who have had access to the bundle prior to the change.
Did you spot an error? Or maybe you just have a suggestion for how we can improve? Leave a comment, or better yet, send us a pull request on GitHub to fix it (in-browser editing, only takes a moment).
Do you have questions, or just want to contribute some newly gained insight? Want to share an example? Please leave a comment. SPiD reads and responds to every question. Additionally, your experience can help others using SPiD, and it can help us continuously improve our documentation.