Delivery settings

Overview

Delivery options define how a product is delivered to the customer and what delivery-related information appears on the confirmation page, in confirmation emails, or in delivery-related parts of the order flow. Depending on the product type and selected delivery type, different setup options can appear.

Delivery type

The Delivery Type setting defines how the product is delivered to the customer. Depending on the selected delivery type, additional setup options can appear.

Use this page for the exact product-level fields. To compare the available delivery approaches first, see Choose a delivery method. To create a web key generator, see Set up a license key generator.

This setting is available for:

• Base product
• Perpetual product
• Recurring product (plan)

 

The Delivery Type setting is not used for bundle products.

The following sections describe the available delivery types and their settings.

License key

Cleverbridge delivers a key

Cleverbridge delivers the license key for the software to the customer.

Use this delivery type when Cleverbridge should deliver license keys through a key list, web key generator, or another supported key delivery setup. When this type is chosen, the following options can be defined:

Option	Description	Use to
Key List	Key list selected for license key delivery.	Deliver keys from a predefined list.
Web Key Generator	Web key generator selected for license key delivery.	Generate license keys dynamically. To set up a new web key generator, use Commerce Assistant. For details, see Key generators.
Key result type	Controls how the key and template are shown to the customer. Options include Auto, Binary, Html, and Text.	Define whether the key is displayed automatically, as binary data, as HTML, or as plain text.
Execute once per purchased quantity	Generates only one key per cart item, regardless of the purchased quantity.	Avoid generating one key for each purchased unit.
Use key template	Uses the key template text that was set up in the Key Template field.	Show the delivered key together with custom confirmation page text.

Cleverbridge can also deliver keys by using an executable key generator or a dynamic-link library (DLL). These options are hosted by Cleverbridge. For more information, contact Client Experience.

 

If a key generation or key list error occurs, Cleverbridge creates an error log entry and makes up to five attempts to generate or obtain the key. If the fifth attempt fails, Customer Support investigates the error unless Client handles errors is activated.

Full-version download

Cleverbridge delivers a full-version download

Cleverbridge delivers the full version of the software to the customer by download.

Use this delivery type when Cleverbridge should provide the full version of the software as a downloadable file. When this type is chosen, the following options can be defined:

Option	Description	Use to
Download File	File that the customer downloads through a link.	Select the downloadable product file. To upload a new file click the Upload product file button.
Link Validity in Days	Number of days for which the download link is valid.	Limit how long the download link remains available to the customer.
Description	Descriptive information displayed with the download link on the confirmation page and confirmation email.	Explain what the customer is downloading or provide short download-related instructions.
Only show download when customer orders in this language	Restricts the download to a specific language in which the customer orders.	Show the download only for orders placed in a selected language.

Client delivery

Client delivery

Use client delivery when the product or license key is delivered outside of Cleverbridge by your own systems or processes.

The following client delivery options are available:

Delivery type	Description	Use to
Client delivers	The full version of the product is delivered to the customer outside of Cleverbridge.	Handle product delivery outside of Cleverbridge.
Client delivers license key	The license key is delivered to the customer outside of Cleverbridge.	Handle license key delivery outside of Cleverbridge.

No additional delivery type options are listed for these delivery types.

Key templates and delivery notes

These settings define custom license key and delivery information shown to customers on the confirmation page or in confirmation emails. They are available for all product types and particularly important for products that use delivery-related confirmation information.

The following settings can be defined:

Field	Description	Use to
Key Template	Custom license key information shown on the confirmation page, such as customer name, product name, or license key number. If left empty, default key template text displays.	Customize how the license key is presented on the confirmation page.
Email Key Template	Key template for the email confirmation.	Use a different key template in the confirmation email than on the confirmation page. If the same template should be used in both places, leave this field blank.
Additional Delivery Note	Additional delivery information shown on the confirmation page. Supports dynamic placeholders.	Provide delivery instructions, installation steps, or other customer-facing delivery details.
Information on Extra Page	Additional information that is too long to fit on the confirmation page.	Create a button on the confirmation page that opens the instructions or product information in a separate window.

 

If you do not want the default key template text to display on the confirmation page, and you do not want to enter custom text, enter only the Key placeholder in the Key Template field.

In this case, if you use a key list, only the license key itself displays. If you use a key generator, neither the default text nor a license key displays.

Placeholders for the key template

Use the following placeholders to insert customer, product, or order information into the Key Template.

Placeholder	Description
<Key>	License key
<RegName>	Customer name
<ProductId>	Product ID
<InternalProductId>	Internal product ID
<[NAME_OF_X_PARAM]>	Corresponding x-parameter
<ProductName>	Name of the ordered product
<Quantity>	Quantity of the ordered product
<ProductTrialUrl>	URL to download a trial version of the product

Example

The following is an example of key template text:

<RegName>, here is your product key for your purchase of <ProductName>.
<Key>

Placeholders for the additional delivery note

Use the following placeholders to insert customer, product, or order information into the Additional Delivery Note.

Placeholder	Description
<ProductId>	Product ID
<InternalProductId>	Internal product ID
<[NAME_OF_X_PARAM]>	Corresponding x-parameter
<ProductName>	Name of the ordered product
<Quantity>	Quantity of the ordered product
<ProductTrialUrl>	URL to download a trial version of the product

Example

The following is an example of additional delivery note text:

<p>Thank you for your order. To download and install your product, please follow these instructions:</p>
<ol>
  <li>Download the installation file by clicking the button below.</li>
  <li>Double-click on the downloaded file to begin installation.</li>
  <li>Follow the onscreen installation instructions.</li>
  <li>When prompted, enter your license key.<br /></li>
</ol>
<p>Please note: The license key is also included in your confirmation email.</p>

Did you find this doc useful?