Creating a product combination

Learn how to create a product combination with one or more components, including subscription components.

In Global Commerce, you can combine two or more products into one virtual product. A product combination is one or more sellable SKUs (components) combined as a single product that a shopper can purchase. It can consist of physical, digital, or subscription products and appears in a response as a single lineItem with the pricing details for that product combination.

If you are interested in using product combinations, contact your Customer Success Manager.

How it works

You can use Commerce API to sell product combinations and Global Commerce to return those combinations. A product combination appears as a lineItem under the lineItems object.

        "lineItems": { // Lists all products
    ...
            "lineItem": [ // Provides information on a product combination, including product details
      ...    
                    "components": { // If the product is a product combination, the components object lists all products included in the product combination.
                        "lineItem": [ // Provide product information on the components in the product combination.  
                          "uri": [ // Provide information on a component in the product combination.  
           ...
  

The first lineItem of a combination product will provide the product details that represent the Product Combination information. However, some details of the first component lineItem, such as lineItemState, lineItemStateDetails, downloads, digitalRights, subscriptionId, billingAgreementId, and subscriptionInfo, will be removed. The pricing details of the first component lineItem will remain unchanged, representing the amounts at the Product Combination level.

In the response, we display only the first lineItem in the components object and remove all others. The lineItem array contains a list of all component lineItems. The list of lineItems in the components object will be the same as the existing lineItem structure.

The product details inside the components lineItem (components -> lineItem array -> product) will have a new recurringSubscriptionInfo block to return subscription details.

You can use the lineItemId to update a product combination's quantity, remove a product combination, etc.

When creating a product combination in Global Commerce, you can include a subscription as one of the components. It allows shoppers to view the bundle as a single product instead of multiple items. This feature allows you to adjust the pricing and positioning of the bundle to suit your needs. You can use the following resources to manage a product combination with subscriptions.

• You can get, update, or clear a cart with a product combination.

• You can manage a product combination as a lineItem in a cart. For example:

  • You can send POST /v1/shoppers/me/carts/active/line-items/{lineItemId}/?format=json&action=add&quantity=2 to change the quantity of the specified line item to 2.

  • You can send POST /v1/shoppers/me/carts/active/line-items/ and include the quantity in the request's body to change the quantity of the specified line item to 2.

curl --location --request POST 'https://api.digitalriver.com/shoppers/v1/shoppers/me/carts/active/line-items/{lineItemId}?format=json*action=add&=quantity=2' \
--header 'authorization: Basic  ***\
...
--data-raw '{
  "quantity" : 2
}'

• You can get an order that contains a product combination by specifying the order's ID.

• You can get a specific product combination from a cart by using its lineItemId.

• You can update one or more product combinations to a cart by using lineItem.

• You can apply a payment method to a cart that contains a product combination. For example, you can send POST /v1/shoppers/me/carts/active/apply-payment-method to update the payment method.

• You can apply a shipping option to a cart that contains a product combination. For example, you can send POST /vi/shoppers/me/carts/active/apply-shipping-option?shippingOptionId={shippingOptionId} to update the shipping method.

• You can apply a shopper to a cart that contains a product combination.

• You can get a product combination by using the product's ID.

You can still add an individual product as a lineItem to a cart.

If you had previously enabled a product combination, you must now determine how to cancel/return a product combination. When you turn on the Cancel/Return Product Combination feature in Global Commerce, it will handle the cancellation of all unfulfilled components and the return of all fulfilled components of the product combination.

Create a product combination with subscription components

Creating a product combination with subscription components allows you to bundle multiple items as a single product offering, enhancing the value for your customers. This process involves configuring the individual components and the subscription features to ensure a seamless purchasing and user experience. Follow the steps outlined below to create and manage your product combination successfully.

The following steps describe how to create a product combination:

• Prerequisites

• Step 1: Enable product combinations

• Step 2: Determine how to cancel/return a product combination

• Step 3: Configure site settings for subscription products

• Step 4: Ensure component products are deployed

• Step 5: Create a product combination with components

Prerequisites

Certain information and settings must be prepared before creating a product combination with components. Below is a list of prerequisites needed to ensure a smooth setup process.

1. Gather the following information before you create the product:

   • Text (TXT) file containing the list of serial numbers or unlock code. The file must contain one code per line (with a hard return between codes).

   • Application file (if the product is downloadable)

   • Product images (thumbnail and full image pictures)

   • Product descriptions (short and long)

   • Export Control Classification Number (ECCN) and Country of Origin

2. Enable product combinations before you create a product combination (with components). For more information, see Enable product combinations.

Step 1: Enable product combinations

Before you create a product combination (with components), you must enable product combinations at the company level.

Required role: Catalog Manager

To enable product combinations:

1. Sign in to Global Commerce.

2. Select Administration, select Company and then click Configure Company Settings. The Configure Company Settings page appears.

3. Click the General tab, scroll down to the Product Combination panel, and toggle the button to Enabled. For a description of the fields., see Product Combinations in the Global Commerce Help

Product Combination

1. Click Save. See Product setup for more information.

Step 2: Determine how to cancel/return a product combination

At the site level, you can determine how Global Commerce handles the cancellation or return of all components in a product combination together. When you enable the Cancel/Return Product Combination feature in Global Commerce, it will handle the cancellation of all unfulfilled components and the return of all fulfilled components of the product combination together.

Prerequisite: You must enable product combinations before creating a product with components.

To enable the cancellation/return of a product combination together:

Required role: Content Manager or Digital River internal user

1. Select Administration, select Site, and then click Configure Site Settings. The Configure Site Settings page appears.

2. Click the Features tab, scroll to Cancel/Return Product Combination, and select Enabled or Disabled. Global Commerce will cancel unfulfilled items when enabled while setting fulfilled ones for return. For a description of the fields, see Cancel/Return Product Combination in the Global Commerce Help.

Cancel/Return Product Combination

1. Click Save.

The everything-or-nothing rule

When you enable the Cancel/Return Product Combination feature in Global Commerce, it tightly combines all the components within the product combination. So when a shopper orders the product combination, the components are shipped and fulfilled by line item. However, if they initiate a cancellation or return of the product combination, the entire product combination will be cancelled or returned. It is the everything-or-nothing rule. The exception to the everything-or-nothing rule is you don't need to cancel a trial product while handling product combination cancellation.

Step 3: Configure site settings for subscription products

Setting up site configurations for subscription products in Global Commerce is essential for properly managing and delivering your subscription-based offerings. This process ensures that your subscription products are correctly integrated and aligned with your overall site settings, providing a seamless shopping experience for your customers. Follow the steps below to configure the necessary settings efficiently. If you don't have subscription products, you can skip this step. If you are going to create subscription products, this step is required.

Required role: Content Manager or Digital River Internal user

1. Scroll down to the Subscriptions pod from the Features tab on the Configure Site Settings page.

2. Complete the fields and select the appropriate checkboxes. For a description of the fields, see Subscriptions in the Global Commerce Help.

Subscriptions

1. Click Save.

2. If your product combination contains one or more subscription products, ensure a product combination meets the following conditions so the system can combine the notifications, billing, and shipping for those subscriptions.

   • Set up at least one subscription in the product combination to allow product combinations.

   • All subscription orders must belong to the same shopper and use the same payment method. Note that Global Commerce does not currently support physical subscription products.

   • You can only combine subscriptions purchased from the same site. You cannot combine subscriptions from different sites owned by the same company.

   • The expiration date must be the same for all subscriptions.

   • The billing and shipping information must be the same for the subscriptions.

   • You must enable the User Autorenew Subscription Combined Renewal notification for the site even if you do not enable combined subscriptions for the product.

   • You must enable the products to be combined and specify the expiration dates within a set number of days on the product setup.

   • A shopper can visit www.findmyorder.com or call Customer Service and choose to combine one or more subscriptions before their expiration date. Complete the search fields and click Search .

Find Products

Step 4: Ensure component products are created and deployed

Creating and deploying component products is essential to ensure that all parts of your product are available and functional. This step involves making sure each individual component—whether digital, physical, or subscription-based—is properly configured and published. Refer to the Creating a product and Deploy products guides for detailed instructions.

Step 5: Create a product combination with components

Creating a product combination with components allows you to bundle various product types—digital, physical, and subscription items—into a single offering. This method simplifies management and enhances the customer experience by providing a unified purchase option. Follow the steps below to create an effective product combination in Global Commerce.

Required role: Content Manager

1. Sign in to Global Commerce.

2. Go to the Product Setup wizard and choose one of the following options:

   • Select Catalog, select Products, and then click Create Product.

   • Select Catalog, select Products, click Manage Product, and then click Create Product.

3. Choose the Product Combinations (with Components) template. See Product setup for more information.

Product Setup

1. Click Next.

2. Select the supported locales. See Supported locales for more information, including requirements for product combinations.

   1. Select the checkbox next to each locale you plan to support.

   2. Select the Default option next to a locale that you want to use as the default. The system will use the default locale to display in your store if the shopper's locale is unknown.

   3. Select the Restrict Product Visibility and Purchasing to Locales Below checkbox if required. Note: When you select this checkbox, you only sell this product to the chosen locales. For product combinations, the supported locales must include those for the components with product visibility and purchasing restrictions. Likewise, the supported locales in the components must consist of the supported locales for the product combination if there are product visibility and purchasing restrictions in the product combination.

   4. Click Next.

Supported Locales

1. Add the product to catalogs and categories. See Catalogs and categories for more information.

   1. Under Add Product to Catalogs, select the checkbox next to each catalog where you want the product to appear. Requirement: The catalog associations must include all its product combination components. For example, if you associate a product combination with catalogs A and B, you must associate all of the components in the product combination with both catalogs.

   2. Under Add Product to Categories, select the checkbox next to each category where you want your product to appear.

   3. Click Next.

Catelogs and Categories

1. Select the product options. See Product options for more information.

   1. If your company has created custom attribute families, select the checkbox next to each option you want to apply to the product. Note: If you create a subscription product, select the Subscription option. To create a Flex Term renewal for a subscription product, see Creating a Flex Term renewal for a subscription product.

   2. Select the fulfillment option for your product and click Next. Note: You can select multiple fulfillment options if you create a product with variations. (Checkboxes instead of option buttons appear next to each fulfillment type.) If you select multiple fulfillment options, you must create a product variation for each. For additional information on creating subscription products, see Creating a Flex Term renewal for a subscription product.

Product Options

1. Configure the product settings. See Product settings for more information.

   1. To change the product settings for the default locale, click the default locale tab and complete the fields. If you click a different locale tab, click Yes when prompted to save your changes.

   2. Click the tab for a locale, select the Override default locale settings checkbox, and complete the fields. If you click a different locale tab, click Yes when prompted to save your changes. Repeat this step for each additional locale.

   3. Click Next.

Product Settings

1. Configure the components for a product combination. See Product Combination for more information. Note: The Product Components step only appears when you select the Product Combination (with Components) option on the Setup Product page. The system combines the billing for all the components into one order. However, the notifications for "shipping (physical)" and "subscription" will be sent on a line item level basis. When a line item is shipped, the system sends a notification to inform the shopper, and these notifications won't wait for the entire order to be shipped. Additionally, every single subscription is on a line item basis, and the subscription notifications are all sent on a line item level, just as they are now.

   1. Click Add.

   2. Complete the search fields and click Search .
   3. Choose one of the following options:

      • To select one or more products, select the checkbox next to each Product ID you want and then click Add Selected Items. Add at least one subscription to the product combination. You can include physical and digital subscription products. You can only combine subscriptions purchased from the same site. You cannot combine subscriptions from different sites owned by the same company.

      • To select all products in the list, select the checkbox next to Product ID, then click Add Selected Items.

      The products appear in the Product Components list.

   4. Click Next.

Product Components

Find Products

1. Assign a price to the product combination. If you don't assign a price on the Pricing step when creating a product combination with components, the system will use the original component's product price. See Pricing for more information.

   1. To display the components associated with the product combination, click the Expand button next to the currency.

   2. For each component in the Pricing list, perform the following steps:

      1. Type the price of each component in the Price fields.

      2. (Optional.) Select the Allow Zero checkbox checkbox next to each component of a promotion or giveaway.

      3. Click Refresh to calculate the price of the product combination.

   3. Repeat steps 1 and 2 in the previous step for each additional currency.

   4. Click Finish. The Edit product page appears.

You acknowledge the Export Compliance Acknowledgment Statement by clicking "Finish" and adding a product combination through this interface. This statement appears at the bottom of the Pricing step.

If the Edit Product page shows any errors, you can correct the errors on the Edit Product page and save the changes.

Pricing

1. Deploy the combination product. See Deploy products for instructions.

Creating a Flex Term renewal for a subscription product

To create a subscription that uses Flex Term renewal:

1. Follow the instructions in Create a product combination with subscription components.

2. When you reach the Product Options step, select the Subscription checkbox.

Product Optons

1. When you reach the Product Settings step, complete the fields under Subscription. See Subscription for more information.

Subscription

1. Choose Flexible Term from the Payment Schedule drop-down list.

2. Select the number of billing cycles from the Number of Billing Cycles drop-down list.

3. Under Reminder Emails, clear the checkboxes associated with Reminders for Automatic Renewals.

4. Choose one or more manual renewal reminder checkboxes associated with Reminder for Manual Renewals.

5. Select one or more checkboxes associated with Update Expired Credit Card to send credit card expiration reminders before billing events.

6. Click Next and complete the rest of the fields in the Product Setup wizard.

Flex Term renewal scenarios

In this section, we will explore different scenarios to illustrate how subscription renewal settings impact the overall pricing strategy for products with flexible terms. Understanding these scenarios will help you manage and anticipate the pricing behaviors of various subscription models, ensuring a seamless experience for you and your customers.

Scenario 1

This scenario explains how price settings affect subscription renewals for a product combination. Initially, the user sets the price model to the Component Price (e.g., $20). After the subscription is created and renewed at this price, the subscription's perpetual price is set at $20. Changing the pricing setting later to use Price List Price (e.g., $50) does not affect the already established perpetual price. Therefore, despite the change in settings, the subscription renewal price remains at the originally set perpetual price of $20.

The steps outline the process as follows:

1. User set to use Component Price (e.g., $20)

2. subscription created

3. subscription renewed (e.g., $20)

4. The user changed the setting to using Price List Price (e.g., $50)

Scenario 2

This scenario highlights the impact of switching pricing models on the subscription's renewal price for a product combination. Initially, the user opts for the Price List Price model, setting the price at $50. Creating and renewing the subscription at this price solidifies the subscription's perpetual price to $50. Even if the user later changes the pricing model to Component Price, reducing the theoretical price to $20, the established perpetual renewal price remains unaffected at $50.

The steps outline the process as follows:

1. The user opts for the Price List Price setting ($50).

2. A subscription is created following this pricing model.

3. The subscription is renewed at $50, cementing this as the perpetual price.

4. Despite the user changing the pricing model to a Component Price ($20), the subscription renewal price adheres to the previously established perpetual price of $50.

This scenario demonstrates that once a perpetual price is established through a subscription's renewal, subsequent changes to the pricing model do not alter the renewal price.

Scenario 3

This scenario elaborates on the process and implications of updating a subscription's renewal price for a product combination through a perpetual pricing mechanism.

The subscription's perpetual price is initially established at $50. Regardless of subsequent amendments to the subscription's pricing model, the renewal price remains constant at the initially set perpetual price of $50.

The steps outline the process as follows:

1. Subscription Creation: The shopper subscribes to a service and initializes their subscription.

2. Perpetual Price Update: The user executes an update via the POST /v1/subscriptions/{subId}/perpetual-price request, modifying the subscription's price.

Despite the Global Commerce mechanism's configuration to adopt the Price List Price for renewals, the system prioritizes the perpetual price set in step 2 for the next renewal cycle. Therefore, even if you toggle the Global Commerce to reflect changes in the Price List Price, the perpetual price updated in Step 2 will override this for renewal billing.

This enhancement ensures a consistent renewal price for the user, regardless of changes in the subscription's pricing model after establishing a perpetual price.