Add technical details for a SaaS offer

  • Article

This article describes how to enter technical details that help the Microsoft commercial marketplace connect to your solution. This connection enables us to provision your offer for the customer if they choose to acquire and manage it. For more details about these settings, see Technical information.

Note

If you choose to process transactions independently, you won't see this option. Instead, skip to How to sell your SaaS offer.

Technical configuration

On the Technical configuration tab, you'll define the technical details that the commercial marketplace uses to communicate to your SaaS application or solution.

  • Landing page URL (required) – Define the SaaS website URL (for example: https://contoso.com/signup) that customers will land on after acquiring your offer from the commercial marketplace and triggering the configuration process from the newly created SaaS subscription.

    Important

    Your landing page should be up and running 24/7. This is the only way you will be notified about new purchases of your SaaS offers made in the commercial marketplace, or configuration requests of an active subscription of an offer. Don't include the pound sign character (#) in the landing page URL. Otherwise, customers will not be able to access your landing page. Do not enter secrets or authorization tokens in the landing page URL.

  • Connection webhook (required) – For all asynchronous events that Microsoft needs to send to you (for example, SaaS subscription has been canceled), we require you to provide a connection webhook URL. We will call this URL to notify you of the event.

    Important

    Your webhook should be up and running 24/7 as this is the only way you will be notified about updates about your customers' SaaS subscriptions that are purchased via the commercial marketplace. Microsoft calls your Webhooks with Authorization headers that contain necessary information to validate the calls. You must enable your Webhooks to be able to receive the Authorization headers. (Do not add authorization details or security tokens like SAS tokens directly in the Webhook URLs. Such Webhooks might fail to retrieve the Authorization headers that Microsoft sends when calling your Webhooks).

  • Microsoft Entra tenant ID (required) – To find the tenant ID for your Microsoft Entra app, go to the App registrations blade in Microsoft Entra ID. In the Display name column, select the app. Then look for the Directory (tenant) ID number listed (for example, 50c464d3-4930-494c-963c-1e951d15360e).

  • Microsoft Entra application ID (required) – To find your application ID, go to the App registrations blade in Microsoft Entra ID. In the Display name column, select the app. Then look for the Application (client) ID number listed (for example, 50c464d3-4930-494c-963c-1e951d15360e).

Select Save draft before continuing to the next tab: Plan overview.

Next steps