Create URLs

Depending on your business need, you can create and shape a variety of links as you can see below:

Create a Destination URL (URL)

To create a destination URL, do the following:

Create the URL in the Link Generator

In the Commerce Assistant, you can set up destination URLs using the Link Generator tool and the contextual panel. For more information about the options available in the Link Generator, see Set Up Your Checkout Pages.

Manually Create the URL

You can manually create destination URLs using the assortment of parameters that Cleverbridge offers. For information about the Cleverbridge URL structure and the available parameters, see Control & Configure Your Checkout Pages Using URL Parameters.

Create a Display URL (PURL)

To create a display URL, you can use the following tools in the Commerce Assistant:

Saved Links Portal

A display URL (PURL) stored in the Commerce Assistant is called a Saved Link. You can create a saved link directly in the Saved Link portal, by copying and pasting an existing link, or by saving a link in the Link Generator after you create it. The following information explains how to create and modify saved links:

 

Tip

The benefits of using saved links are:

MVT Campaign Portal

The following explains how to create and alter display URLs in the MVT Campaign portal:

Create a Protected URL (UURL)

Warning

Do not use protected URLs (UURLs) if you plan on creating a large quantity of URLs (10,000 or more). This can hurt the Cleverbridge platform and slow down your customers' checkout experience. If you plan on creating a large quantity of URLs, you should use session URLs (SURLs) or dynamic protected URLs (dynamic UURLs). For more information, contact Client Experience.

The following information explains how to create and alter protected URLs:

Protect a URL in the Commerce Assistant

In the Link Generator, you can create a protected URL. A protected URL is an orderClosed An agreement between a seller and a buyer to exchange goods and/or services for money. An order can: - contain multiple products and quantities; - have multiple financial transactions. A preorder authorization is considered an order. URL containing a masked component invisible to customers. By using a protected URL, you can control the content of the shopping cart and protect private information, such as product price. To protect a link, complete the following steps:

  1. Click Protect in the action bar of the Link Generator. A window opens displaying the options for protecting the link.

    link gen quick start protect window

  2. Select from the following options:
  3. Do one of the following:
    • To display the UURL in the URL field, click Generate.
    • To copy the link to the clipboard, click Copy.
    • To open the link in a browser, click Open.
    • To close the link generator, click Close.

Example of a protected URL:

https://www.shieldwareexamplecompany.com/123/uurl-jdegscwdyz

Edit a Protected URL

You can use the Edit Protected URL portal to change the settings of a protected URL that has been generated with the Link Generator.

To edit a protected URL, complete the following steps:

  1. Copy the URL you want to change.
  2. In the main menu, click Tools > Edit Protected URL. The Edit Protected URL window displays.
  3. In the Unique URL field, paste the URL.
  4. Click OK. If the URL is valid, the Edit Protected URL portal opens.
  5. Enter information in the following sections:

  6. Click Save.

Create a Session URL (SURL)

To generate a SURL, you can use the REST API. For more information, see the Generate User Session URL.

Important

The targetUrl that you send in the API request must be encoded. For more information, see HTML URL Encoding Reference.

Tips

  1. Use session URLs to implement a Single Sign-On (SSO). With SSO, Cleverbridge loads your customer's existing billing profile on the checkout page. We also extend the profile with any additional parameter values that you provide in the URL. For more information, see Single Sign-On (SSO).
  2. Use session URLs to pass tracking information through the checkout process via x-parameters. For more information about x-parameters and how to use them effectively, see Revenue Tracking.

Create a Dynamic Protected URL (Dynamic UURL)

Warning

Cleverbridge offers URL protection through the use of a checksum 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 steps:

  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