Last Modified May 1, 2026

Adding Product Upgrades

  1. Summary
  2. Adding a custom field in the PayPro Order Form
  3. Setting Upgrade parameters

 

Updating the <license_data> field in the License CDM file

When using Feature-Based Licensing, you can have <license_data> information (such as which Features should be active) included in the CDM License File based on the specific product purchased in PayPro. Your application can query the ".CDM" License File on start-up and offer only the purchased features.

You can offer Upgrade Products in PayPro where the <license_data> is updated (ex: more features now available).

To enable this automated update, you will need to add a mandatory Custom Field in the PayPro Order Form used to capture the License Activation Code to which this upgrade applies.

The following sections explain how to add a Custom Field, and the parameters to use in the PayPro product configuration.

Updating the <seat> setting of the License

For Multi-User and Floating Licenses, you can offer Upgrade Products in PayPro where the <seat> setting for the License is updated (ex: more seats now available).

To enable this automated update, you will need to add a mandatory Custom Field in the PayPro Order Form used to capture the License Activation Code to which this upgrade applies.

The following sections explain how to add a Custom Field, and the parameters to use in the PayPro product configuration.

 

Adding a custom field in the PayPro Order Form

You will need to create a Order Page Template specifically for your Product Upgrades that will include the Custom Field for only those Products, as follows:

  1. From the Home screen, click on Store Settings -> Page Templates
  2. Click on Add Page Template, or Duplicate to copy an exsiting template and configure as per your requirements. Ensure you only select the upgrade product that will use this Order Form Template
  3. Once complete, click on the 2 Advanced editing tab and check Use Custom Fields and click on Add New
    Order Test Mode
  4. Select for Type, check Mandatory to make it a mandatory field, and enter a Label for the input box.
    Order Test Mode
  5. Click on Finish

When a Buyer selects this upgrade Product, he will be asked to enter the License Activation Code to which this upgrade applies. The License Activation Code will be updated in software_DNA with the new <license_data> or <seat> information specified for this upgrade Product:

  • as specified in the PayPro License Manager tied to this Upgrade Product (see next section)
  • as specified in the DNA Connector configuration for this PayPro Product ID

 

Setting Upgrade parameters

If you want to specify the Upgrade settings in PayPro instead of in the DNA Connector, you can specify them in the PayPro License Provider configuration tied to this upgrade Product.

In the Custom License Info field of the License Provider, you can add the following:

Parameter / Value Example Comment
secret=<dna_secret> secret=snow2025 Mandatory
3 to 50 alphanumeric, no spaces
license_data=<license_data> license_data=Pro Optional
0 to 50 alphanumeric, space(s), +-_#%/.,@();:
seat=<seat> seat=10 Optional
integer