Skip to main content
All CollectionsMicrosoft commercial marketplaceProduct listings
Set up your Microsoft buyer registration page
Set up your Microsoft buyer registration page

Create a registration page for your Microsoft listings to facilitate buyer registration and ensure details are sent to you from Tackle.

Leslie avatar
Written by Leslie
Updated over 3 weeks ago

Microsoft commercial marketplace requires you to provide a SaaS URL that could be a registration page or direct login for each product you are selling. That way, buyers who initiate a transaction on the marketplace can register on your website. While you can host a registration page in your company's domain, the benefits of using a Tackle-hosted registration page are:

  • It is included with your Tackle subscription

  • No engineering is required to set up the page

  • All buyer registration details will be sent to you from Tackle

  • You have some flexibility in how the registration page will look and flow

You can use the Tackle-hosted registration page or your own self-hosted registration page.

Select the Tackle-hosted registration page

  1. In Tackle, go to the left menu and click Listings🔗.

  2. Select your product listing.

  3. Click Registration Details.

  4. Select Tackle hosted.

  5. Here you can see the registration page that has already been built for you by Tackle and make any necessary edits. These edits will take effect immediately.

Select the self-hosted registration page

  1. In Tackle, go to the left menu and click Listings🔗.

  2. Select your product listing.

  3. Click Registration Details.

  4. Select Self-hosted.

  5. Here you can input the registration link that was configured by your developers.

Set up your own self-hosted registration page

A public URL is required for your self-hosted registration page to be accessible to all marketplace buyers. In addition, specific query parameters are required so that information can flow from your self-hosted registration back to Tackle.

Additionally, if you plan to transact on Microsoft commercial marketplace, your registration page must connect to a Microsoft Entra application to retrieve customer information. Instructions to create this application are available from Microsoft🔗. Note that the step “Use two Microsoft Entra apps to improve security in production” can be safely omitted - the integration with Tackle’s Registration API achieves the separation of concerns intended by this step.

These query parameters are set when Tackle calls your self-hosted registration page URL:

Customer ID (<cloud>_customer_id)
Product ID (<cloud>_product_id)

Important

Offer type will only be set for free trial offers and will then have a value of free-trial.

Send Tackle your self-hosted registration page information

  1. Once you select the Self-hosted registration page and input your registration page link, all buyers who initiate transactions with you in the marketplace will be sent to your self-hosted registration page. They will need to enter required information (the buyer's company name, full name and email) and any other registration details you request.

  2. Once your self-hosted registration page is live, use the customerid and productid as request body parameters in the Tackle Registration API🔗 to send the buyer's registration information to Tackle. The fields correspond to the fields defined in the registration page fields for a given listing. You can also set registration details in your listing registration page and these will be sent back to Tackle as described in the Tackle Registration API🔗.

Tip

You can use information gathered from your self-hosted registration page to build your own automated fulfillment processes (like auto-provisioning)

Select Azure Native Services registration page

For Microsoft commercial marketplace listings, if you are engaged with Microsoft to list an Azure Native Service listing, Microsoft will manage your registration page. You can bring your Azure Native Service listing to Tackle to create private offers, receive notifications, and use reporting, but no registration integration will be available. Selecting this option allows Tackle to notify you without registration being require.

Did this answer your question?