Skip to content

License Setup

The merchantCENTRAL License Setup page is the central management page for your merchantCENTRAL license. Here you can see the current license status, configure your License Key, and test the connection to the license server.

Opening the Page

  • Via search: merchantCENTRAL License Setup
  • Via the Dashboard β†’ FactBox License Status β†’ Action License Setup
  • Via the License Overview β†’ Action License Setup

Sections

Environment

Shows the automatically detected information about your Business Central environment:

Field Description
Tenant ID Your Microsoft Entra ID (Azure AD) tenant ID. Detected automatically.
Environment Name The name of your Business Central environment (e.g., "Production" or "Sandbox").
Is Production Indicates whether this is a production environment.
Is Sandbox Indicates whether this is a sandbox environment. In sandbox environments, all modules are usable without restrictions.

Environment is detected automatically

The environment data is determined automatically on first access. If your environment has changed (e.g., after a migration), you can use the Detect Environment action.

License

Field Description
License Key Shows whether a License Key is configured: "Configured" or "Not configured". The key itself is not displayed for security reasons.
License Status The current status of your license (Active, Demo, Expired, Suspended).
License Type Demo or Production.
Demo Start Date (Demo only) The date your trial period started.
Demo Expiry Date (Demo only) The date your trial period ends.
Status Details A human-readable description of your current license status (e.g., "Demo (12 days remaining)").

Validation

Field Description
Last Validation Timestamp of the last successful license check against the server.
Next Validation Due Timestamp of the next automatic check (typically every 24 hours).
Last Heartbeat Timestamp of the last heartbeat that sent usage data to the license server.
Grace Period Active Indicates whether the offline tolerance is active because the license server was unreachable. See Troubleshooting.

Licensed Modules

Below the fields, a list of all licensed modules shows the status of each connector:

Column Description
Module Code The unique code of the module (e.g., AMAZON, DHL, JARLTECH).
Module Name The display name of the module.
Module Type Marketplace, Supplier, Shipment, or Extension.
Status Active (green), Demo (yellow), Expired (red), or Suspended (red).
Demo Expiry Date (Demo only) When the trial period for this module ends.
Remaining Shows the remaining demo days or the current status.
Licensed Since (Production license only) Since when the module has been actively licensed.

Actions

Set License Key

Securely stores your merchantCENTRAL License Key in Business Central's encrypted IsolatedStorage.

  1. Click Set License Key
  2. An input dialog appears β€” the key is displayed masked (****)
  3. Enter the License Key you received from your sales contact
  4. Click OK

Success message

"The license key has been stored successfully."

Security note

The License Key is stored encrypted in Business Central's IsolatedStorage β€” not in the database. It cannot be read or displayed.

Delete License Key

Removes the stored License Key. This action is only available when a key is configured.

Caution

After deleting the License Key, license validation is no longer possible. All modules will be suspended after the Grace Period expires.

Validate Now

Triggers an immediate license check against the license server. Normally, the check occurs automatically every 24 hours, but this action allows you to update the status immediately.

Typical use cases:

  • After entering the License Key for the first time
  • After a license change by sales (e.g., new module activated)
  • To verify after a network issue

Detect Environment

Re-detects the current environment properties (Tenant ID, Environment Name, Production/Sandbox). Use this action after an environment migration or rename.

Test Connection

Checks connectivity to the merchantCENTRAL license server. The test sends a simple health request and displays the result.

Possible results:

Result Meaning
"Connection to the license service was successful." Everything is fine
"Could not connect to the license service." Check URL, check network β†’ see Troubleshooting
"License service returned HTTP status ..." Server reachable but error β†’ contact support

Start Free Demo

Opens the Demo Registration Wizard. This action is only visible when no License Key is configured yet.

Prerequisites

Before the License Setup works, the License Service section must be configured in the merchantCENTRAL Setup page (search: merchantCENTRAL Setup):

Setting Description Example
License Function URL The URL of the license server https://mclicensing.azurewebsites.net
License Function Key The API key for the server connection (stored encrypted)

Usually pre-filled

In many installations, these values are already pre-filled. If not, contact your ALTENBRAND representative.