Help Center/ KooGallery/ Seller Guide/ Product Management/ Upgrade and Billing Rules
Updated on 2023-08-04 GMT+08:00

Upgrade and Billing Rules

You can set rules for upgrading released SaaS products on the Product Management > My Products page. Before upgrading products, set parameters on the Application Access Debugging page, generate a link address, and invoke and debug the interface. Ensure that the debugging is successful and save the case.

Specification Upgrade Rules

  1. Currently, only yearly/monthly SKUs of SaaS products can be upgraded. They can be upgraded to other yearly/monthly SKUs under the same specification.
  2. Specification upgrade is not supported for products removed from the catalog. If a specification is removed, its upgrade rule automatically becomes invalid.
  3. If the original or target specification is changed to a billing mode other than yearly/monthly, its upgrade rule becomes invalid.
  4. When the price of a specification changes and causes a price conflict, its upgrade rule automatically becomes invalid.

Product Change Fee

  1. Upgrade fee = Price of new configuration x Remaining days x Discount – Price of original configuration x Remaining days x Discount

1) Price of new configuration: price of the new product calculated on the basis of the remaining duration.

2) Price of original configuration: price of the original product calculated on the basis of the purchased duration.

  1. Capacity expansion fee

Original billing rule (before June 12, 2023):

Linear pricing, tiered pricing, and volume pricing: Capacity expansion fee = Unit price of the volume to which the total number of users belongs after expansion x Total number of users after expansion x Remaining period x Discount – Original price before expansion x Remaining period x Discount

New billing rule (after June 12, 2023):

1) Linear pricing and tiered pricing: Capacity expansion fee = Unit price of the volume to which the total number of users belongs after expansion x Total number of users after expansion x Remaining period x Discount – Original price before expansion x Remaining period x Discount

2) Volume pricing: Capacity expansion fee = Unit price of the volume to which the total number of users belongs after expansion x Number of added users x Remaining days x Discount

Debugging Application Access

  1. Go to the Seller Console.
  2. In the navigation pane, choose Application Tools > Case Management. Locate the interface address of the product to be upgraded, and click Debug in the Operation column.

  3. On the Application Access Debugging page, click the Upgrade tab, set the parameters, click Generate Link Address, and click Debug and Save Case.

    Ensure that the upgrade interface is debugged successfully and save the case. Otherwise, the product upgrade cannot be performed.

Setting a Specification Upgrade Rule

After the upgrade interface is debugged successfully, you can set upgrade rules for products.

  1. Go to the Seller Console.
  2. In the navigation pane, choose Product Management > My Products. On the displayed page, locate the target product and choose More > Set Upgrade Rule in the Operation column.

  3. Click Create Upgrade Rule and select the source and target specifications in the displayed dialog box.

    Figure 1 Setting upgrade rules

    Figure 2 Creating a rule

    • No upgrade rules are configured by default. You can add upgrade rules as required.
    • When creating a rule, the available target specifications are displayed only after you select the source specification.
    • When upgrading a specification that is priced using a custom template, the specification is selected as the target specification by default.
    • If the selected specification that is priced using a custom template contains quantity attributes, the Capacity Expansion Step parameter is displayed. The capacity expansion step must be a multiple of the original step. A maximum of five times of the original step can be set.
    • Only one upgrade rule can be created for a source specification. You can modify the upgrade rule, or delete it and create a new one.
    • An upgrade rule takes effect only when the price of the target specification is higher than that of the source specification.

  4. Click OK.
  5. For a specification that is priced using a custom template, you need to set attribute upgrade rules under the specification. Otherwise, the specification supports only quantity increases and does not support the upgrade between enumeration attributes.

    Locate the target upgrade rule and choose More > Set Attribute Upgrade Rule in the Operation column. In the displayed dialog box, select the source attribute name and value, and the target attribute values.

    Figure 3 Setting an upgrade rule

    Figure 4 Creating an attribute upgrade rule

    Select the source attribute name, then select the source attribute value, and then select the target attribute values.

  6. For a specification that is priced using a custom template, you can locate a specification upgrade rule and click the arrow on the left to view all attribute upgrade rules of the specification. You can set, modify, and delete attribute upgrade rules.

    • No attribute upgrade rules are configured by default. You can add attribute upgrade rules as required.
    • Upgrade rules of only one source attribute can be created for a specification that is priced using a custom template. If upgrade rules of an attribute have been created but you want to create upgrade rules for another attribute of the same specification, you need to delete all existing attribute upgrade rules and create upgrade rules for the desired attribute.
    • Only one attribute upgrade rule can be created for a source attribute value. You can modify the existing upgrade rule or delete it and create a new one.
    • An attribute upgrade rule takes effect only when the price of the specification with the target attribute value is higher than that of the specification with the source attribute value.

Verifying New Product Prices

If the prices of the source and target specifications are not properly set during product modification, the price of the target specifications may be lower than that of the source specifications. After modifying the price of a product, you can verify whether the upgrade rules still take effect. Click Verify Upgrade Rule or Submit to verify the upgrade rules.

If the verification fails, delete the upgrade rules or change the price.

If the verification is successful, click OK to submit the modification application.