Bundles & Cross-sell

Bundles

Bundles are fixed sets of products sold together at a discounted price.

// List all active bundles
const { items: bundles } = await client.catalog.getBundles();

// Get bundle detail
const bundle = await client.catalog.getBundle('starter-pack');
// { id, name, slug, price, items: [...], isActive }

Add Bundle to Cart

const cart = await client.cart.addBundle('bundle-id', 1);

At checkout, bundle components are expanded into individual order items with proportional pricing.

Cross-sell

Get related, upsell, and cross-sell products for a specific product. Pass an optional locale and currency so the cards come back localized and priced in the currency you display:

const result = await client.catalog.getCrossSell('wireless-headphones', {
  locale: 'cs',
  currency: 'CZK',
});

Response

{
  related: CrossSellItem[],    // Similar products (podobné produkty)
  upsell: CrossSellItem[],     // Higher-value alternatives (dražší varianta)
  crossSell: CrossSellItem[],  // Complementary products (doporučené k nákupu)
}

Each CrossSellItem carries productId, slug, name (localized), sku, price and compareAtPrice (in currency), imageUrl, stockCached and inStock. The price already includes any price-list override for the logged-in customer, so you can render the same card component you use for getFeatured and getProductGroup.