Variant Bundles

It is possible to combine multiple variants into a single order product and have each of the variants fulfilled. This is advantageous to allow consumers to choose variants sold as a bundle.

For example, a package of 5 t-shirts is sold for $29.99. The consumer can choose color, size, and quantity of each shirt. This pricing does not lend itself to a traditional product & variant. Instead designate the product as a bundle AND submit the order with a separate product & variant combination for each variant. The variants will be combined into a single product (5-pack) on the order but each chosen shirt will be fulfilled.

First, enable this functionality on the product. The checkbox is available only after variants are created on the product.

Second, pass regular product and variant parameters passed into the order/import or upsale/import API. Here is an example for a bundle of 3 variants:

product1_id = {campaign product Id}
variant1_id= {variant detail Id for first variant}
product1_qty = {quantity of first variant}
product2_id = {campaign product Id}
variant2_id= {variant detail Id for second variant}
product2_qty = {quantity of second variant}
product3_id = {campaign product Id}
variant3_id= {variant detail Id for third variant}
product3_qty = {quantity of third variant}

Full API documentation is here.

The variants will be automatically combined into a single order line item for the product.

 

Notes:

  1. Additional products are allowed on the order. Only the products with the Bundle Variants checkbox will be combined.

  2. The product may be recurring. The variants will be fulfilled on each subsequent billing. Variants may be edited manually on the Purchase Details page.

  3. The bundled variants must all be of the same base product.

  4. The combined order product will have a quantity of 1. You must control the quantity of each variant. For example, if the product is a 5-pack of t-shirts, it is the responsibility of the page to validate that variant quantities add up to 5. The order/import and upsale/import API do no quantity validation.

  5. This is available with a direct API integration only. It does not work with Konnektive form code or in manual order entry.

  6. Variant IDs are available in the campaign/query API response. Details here.