# Creating a product combination

In [Global Commerce](https://gc.digitalriver.com/gc/ent/login.do), 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](https://gc.digitalriver.com/gc/ent/login.do) to return those combinations. A product combination appears as a `lineItem` under the `lineItems` object.

<pre class="language-javascript"><code class="lang-javascript">        "lineItems": { // Lists all products
    ...
            "lineItem": [ // Provides information on a product combination, including product details
      ...    
<strong>                    "components": { // If the product is a product combination, the components object lists all products included in the product combination.
</strong>                        "lineItem": [ // Provide product information on the components in the product combination.  
                          "uri": [ // Provide information on a component in the product combination.  
           ...
  
</code></pre>

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.&#x20;

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](#create-a-product-combination-with-subscription-components) in [Global Commerce](https://gc.digitalriver.com/gc/ent/login.do), 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](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/getting-the-current-cart), [update](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/creating-or-updating-a-cart), or [clear a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-line-items#deleting-all-line-items-from-a-cart) with a product combination.&#x20;
* You can [manage a product combination as a `lineItem` in a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-line-items). 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.

```http
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](https://docs.digitalriver.com/commerce-api/shopper-apis/orders-1/getting-orders#getting-an-order-by-id).
* You can [get a specific product combination from a cart by using its `lineItemId`](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-line-items#getting-a-specific-line-item-from-a-cart).
* You can [update one or more product combinations to a cart by using `lineItem`](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-line-items#updating-one-or-more-line-items-to-a-cart).
* You can [apply a payment method to a cart](https://docs.digitalriver.com/commerce-api/payments/sources/using-the-source-identifier#best-practice-1-use-apply-payment-method) that contains a product combination. For example, you can send `POST /v1/shoppers/me/carts/active/apply-payment-method` to update the payment method.&#x20;
* You can [apply a shipping option](https://app.gitbook.com/s/X2fWaY1Kp5sXA1fmOL7z/cart/apply-a-shipping-option#v1-shoppers-me-carts-active-apply-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.&#x20;
* You can [apply a shopper to a cart](https://app.gitbook.com/s/X2fWaY1Kp5sXA1fmOL7z/cart/apply-a-shipping-option#v1-shoppers-me-carts-active-apply-shipping-option) that contains a product combination.&#x20;
* You can [get a product combination by using the product's ID](https://docs.digitalriver.com/commerce-api/shopper-apis/product-discovery/products#getting-a-base-product-individual-product-or-product-combinations).&#x20;

You can still [add an individual product as a `lineItem` to a cart](https://docs.digitalriver.com/commerce-api/shopper-apis/cart/managing-line-items#adding-line-items-to-a-cart).&#x20;

If you had previously enabled a product combination, you must now determine [how to cancel/return a product combination](#step-3-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](#prerequisites)
* [Step 1: Enable product combinations](#step-1-enable-product-combinations)
* [Step 2: Determine how to cancel/return a product combination](#step-2-determine-how-to-cancel-return-a-product-combination)
* [Step 3: Configure site settings for subscription products](#step-3-configure-site-settings-for-subscription-products)
* [Step 4: Ensure component products are deployed](#step-4-ensure-component-products-are-deployed)
* [Step 5: Create a product combination with components](#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:&#x20;
   * 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)&#x20;
   * Product images (thumbnail and full image pictures)&#x20;
   * Product descriptions (short and long)&#x20;
   * 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).

### Step 1: Enable product combinations

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

{% hint style="info" %}
**Required role**: Catalog Manager
{% endhint %}

To enable product combinations:

1. Sign in to [Global Commerce](https://gc.digitalriver.com/gc/ent/login.do).
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](https://help.digitalriver.com/help/gc/Administration/Company/Configuring-company-settings.htm#ProductCombination) in the [Global Commerce Help](https://help.digitalriver.com/help/gc.htm)

<div align="left"><figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FQGNTc60szs8e5rbaIDvO%2FProduct%20Combiation.png?alt=media&#x26;token=6b142e9a-fc97-441d-bb04-cb85d50cd82e" alt=""><figcaption><p>Product Combination</p></figcaption></figure></div>

4. Click **Save**. See [Product setup](https://help.digitalriver.com/help/gc/Products/Products/Product%20setup.htm) 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.

{% hint style="warning" %}
**Prerequisite**: You must [enable product combinations](#step-2-enable-product-combinations) before creating a product with components.
{% endhint %}

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

{% hint style="info" %}
**Required role**: Content Manager or Digital River internal user
{% endhint %}

1. Select **Administration**, select **Site**, and then click **Configure Site Settings**. The Configure Site Settings page appears.&#x20;
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](https://help.digitalriver.com/help/gc/Administration/Site/Configuring-site-settings.htm#CancelReturnProductCombination) in the [Global Commerce Help](https://help.digitalriver.com/help/gc.htm).

<div align="left"><figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FCzItpl4bzSPw2VVHfPvf%2FCancel%20Return%20Product%20Combination.png?alt=media&#x26;token=69582373-8f56-4b4e-af02-501c1c4d4f27" alt=""><figcaption><p>Cancel/Return Product Combination</p></figcaption></figure></div>

3. 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.&#x20;

### 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.

{% hint style="info" %}
**Required role**: Content Manager or Digital River Internal user
{% endhint %}

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](https://help.digitalriver.com/help/gc/Administration/Site/Configuring-site-settings.htm#Subscriptions) in the [Global Commerce Help](https://help.digitalriver.com/help/gc.htm).

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2F614eW3xf63HA3ksm2sSk%2FSubscriptions.png?alt=media&#x26;token=00b6a880-6551-4ef0-b0d6-ac8a554bbe9c" alt=""><figcaption><p>Subscriptions</p></figcaption></figure>

3. Click **Save**.
4. 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](https://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**  ![](https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FC0ohNSt96yAkQg7z20IF%2Fsearch.png?alt=media\&token=d505f8bf-7cde-4c7c-a3b5-3fd5f773ac21).

<div align="left"><figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FlyaB2eAZ1YDqJQ1GkLIl%2FFind-products.png?alt=media&#x26;token=87756566-4bcf-4e7d-98fe-af01efb137ab" alt=""><figcaption><p>Find Products</p></figcaption></figure></div>

### 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](https://help.digitalriver.com/help/gc/Products/All-Products/Creating-a-product.htm) and [Deploy products](https://help.digitalriver.com/help/gc/Products/All-Products/Deploying-products.htm) 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](https://gc.digitalriver.com/gc/ent/login.do).

{% hint style="info" %}
**Required role**: Content Manager
{% endhint %}

1. Sign in to [Global Commerce](https://gc.digitalriver.com/gc/ent/login.do).
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](https://help.digitalriver.com/help/gc/Products/Products/Product%20setup.htm) for more information.

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2Ff6BYGsLtB2f65FrxMlcB%2FProduct-setup-product-combination-with-components.png?alt=media&#x26;token=2d5379a5-e6c9-406c-8f7c-55f622535780" alt=""><figcaption><p>Product Setup</p></figcaption></figure>

4. Click **Next**.
5. Select the supported locales. See [Supported locales](https://help.digitalriver.com/help/gc/Products/Products/Supported-locales.htm) 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**.

<div align="left"><figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FPWDB7gcBnCpenwSFUw9O%2Fcreate-product-supported-locales.png?alt=media&#x26;token=82252bd7-2a10-4897-8a7d-8da44061c7a8" alt=""><figcaption><p>Supported Locales</p></figcaption></figure></div>

6. Add the product to catalogs and categories. See [Catalogs and categories](https://help.digitalriver.com/help/gc/Catalog/Catalogs-and-Categories/Catalogs-and-categories.htm) 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**.

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2Fcxi8j8a0YNWH1fwyVsHX%2Fcreate-products-catalogs-and-categories.png?alt=media&#x26;token=53d7ac9a-b0af-4a04-8a09-ea858eb11fc5" alt=""><figcaption><p>Catelogs and Categories</p></figcaption></figure>

7. Select the product options. See [Product options](https://help.digitalriver.com/help/gc/Products/All-Products/Selecting-product-options.htm) for more information.
   1. If your company has created[ custom attribute families](https://help.digitalriver.com/help/gc/Products/Products.htm#Custom), 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](#creating-a-flex-term-renewal-for-a-subscription-product).&#x20;
   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](#creating-a-flex-term-renewal-for-a-subscription-product).

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FVKQA7nZhslOZfBrQ9wi0%2Fcreate-product-product-options.png?alt=media&#x26;token=ba560686-bee6-45a5-9520-24574db33d0e" alt=""><figcaption><p>Product Options</p></figcaption></figure>

8. Configure the product settings. See [Product settings](https://help.digitalriver.com/help/gc/Products/All-Products/Configuring-the-product-settings.htm) 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**.

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FprWg4AGLU64MfuuwsX1Z%2Fcreate-product-product-settings.png?alt=media&#x26;token=c64cc734-15cf-4a6a-90a7-cdb89051a3c1" alt=""><figcaption><p>Product Settings</p></figcaption></figure>

9. Configure the components for a product combination. See [Product Combination](https://help.digitalriver.com/help/gc/Products/All-Products/Selecting-the-product-components.htm) 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** ![](https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FC0ohNSt96yAkQg7z20IF%2Fsearch.png?alt=media\&token=d505f8bf-7cde-4c7c-a3b5-3fd5f773ac21).
   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**.

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2Fm4sfRKZM3842oE7jNTZl%2FProduct-components-blank.png?alt=media&#x26;token=c938aad6-0006-46c9-916b-2ac1d1a673f7" alt=""><figcaption><p>Product Components</p></figcaption></figure>

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FAQjnlANsZS7KzK7OOg61%2FFind-products.png?alt=media&#x26;token=3198df6f-7b55-40ee-88e9-0fc654c976f4" alt=""><figcaption><p>Find Products</p></figcaption></figure>

10. 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](#step-5-create-a-product-combination-with-components), the system will use the original component's product price. See [Pricing ](https://help.digitalriver.com/help/gc/Products/Products/Pricing.htm)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](https://help.digitalriver.com/help/gc/Products/All-Products/Editing-a-product.htm) page appears.

{% hint style="warning" %}
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.
{% endhint %}

{% hint style="info" %}
If the Edit Product page shows any errors, you can correct the errors on the Edit Product page and save the changes.
{% endhint %}

<figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2F68iiVZ19TlPuHPYgE5Zh%2FPricing%20combination%20products.png?alt=media&#x26;token=cfc2f478-3251-41d3-b7b4-464a24a478bc" alt=""><figcaption><p>Pricing</p></figcaption></figure>

11. Deploy the combination product. See [Deploy products](https://help.digitalriver.com/help/gc/Products/All-Products/Deploying-products.htm) for instructions.&#x20;

## 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](#create-a-product-combination-with-subscription-components).&#x20;
2. When you reach the Product Options step, select the **Subscription** checkbox.

<div align="left"><figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FBYoJCdgxhSgvVSuvB0nB%2Fcreate-product-product-options-subscriptions.png?alt=media&#x26;token=224381f7-e7e4-433d-8753-132766df3d15" alt=""><figcaption><p>Product Optons</p></figcaption></figure></div>

3. When you reach the Product Settings step, complete the fields under **Subscription**. See [Subscription ](https://help.digitalriver.com/help/gc/Products/All-Products/Configuring-the-product-settings.htm#subscription)for more information.

<div align="left"><figure><img src="https://2721412755-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzlYMEYC0GeLSgnsft6%2Fuploads%2FhcFBYhTaQ8xo2Bz34J9y%2Fcreate-product-product-settings-subscription.png?alt=media&#x26;token=120fe8e9-02d1-4782-b816-76b80ad9983a" alt=""><figcaption><p>Subscription</p></figcaption></figure></div>

4. Choose **Flexible Term** from the **Payment Schedule** drop-down list.
5. Select the number of billing cycles from the **Number of Billing Cycles** drop-down list.&#x20;
6. Under **Reminder Emails**, clear the checkboxes associated with **Reminders for Automatic Renewals**.&#x20;
7. Choose one or more manual renewal reminder checkboxes associated with **Reminder for Manual Renewals**.&#x20;
8. Select one or more checkboxes associated with **Update Expired Credit Card** to send credit card expiration reminders before billing events.&#x20;
9. 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.