Check out the new features, minor fixes, and updates we've made to our platform and APIsChangelog
Home >

Create a Dynamic Protected URL (Dynamic UURL)

Warning

cleverbridge offers URL protection through the use of a checksum that is based on your Seed for query protection in the Commerce Assistant. Never disclose the seed to customers or third parties. Do not include the seed itself in applications shipped to customers.

To create a dynamic protected URL, complete the following:

  1. In the main menu of the Commerce Assistant, select Setup > Account Setup.
  2. Under General, select the Additional Details tab.
  3. Define the Seed for query protection.

    Example

    67bM8Wo0rC35082QzIl1e435

  4. Click Save.
  5. Create a link that includes the urlident and urlvalidurl parameters. Optionally, you can also include the urlusage parameter. For more information about the parameters, see Dynamic Protected URLs.

    Example

    https://www.cleverbridge.com/864/?scope=checkout&cart=s4014&dp_89858=__PRICE:666:USD,666:EUR;N&dp_89859=__PRICE:999:USD,999:EUR;N&urlident=specialoffer0142&urlvaliduntil=2018-11-30

  6. Extract the query string of the URL, add the Seed for query protection to the end of the string, and encode the query string using the encodeURIComponent JavaScript function. For more information, see encodeURComponent().

    Example

    scope=checkout&cart=s4014&dp_89858=__PRICE:666:USD,666:EUR;N&dp_89859=__PRICE:999:USD,999:EUR;N&urlident=specialoffer0142&urlvaliduntil=2018-11-3067bM8Wo0rC35082QzIl1e435

  7. Calculate the MD5 hash using the encoded string and add the MD5 hash to the URL using the queryhash parameter. The URL is now protected and cannot be manipulated by the customer. For more information about the parameters, see Dynamic Protected URLs.

    Example

    https://www.cleverbridge.com/864/?scope=checkout&cart=s4014&dp_89858=__PRICE:666:USD,666:EUR;N&dp_89859=__PRICE:999:USD,999:EUR;N&urlident=specialoffer0142&urlvaliduntil=2018-11-30&queryhash=1232759149e4d5e8ecccf3ddffca4112