Share via

Create a subscription for commercial marketplace products

  • Article

You can create a subscription for commercial marketplace products using Partner Center APIs. You must get a list of offers for a market, create and submit an order for a commercial marketplace subscription, then retrieve an activation link.

You can also perform lifecycle management and manage invoices for these subscriptions.

Prerequisites

  • Partner Center authentication credentials. This scenario supports authentication with both standalone App and App+User credentials.
  • The customer identifier. If you don't have a customer's identifier, follow the steps in Get a list of customers. Alternatively, sign in to Partner Center, choose the customer from the list of customers, select Account, then save their Microsoft ID.

Get a list of offers for a market

You can check the available offers for a market using the following Partner Center API models:

  • Product: A grouping construct for purchasable goods or services. A product itself isn't a purchasable item.
  • SKU: A purchasable Stock Keeping Unit (SKU) under a product. SKUs represent the different shapes of the product.
  • Availability: A configuration in which a SKU is available for purchase (such as country/region, currency, or industry segment).

Before you purchase an Azure reservation, complete the following steps:

  1. Identify and retrieve the product and SKU that you want to purchase. If you already know the Product ID and SKU ID, select them.

    Note

    You can identify commercial marketplace products by their ProductType property of "Azure" and their SubType property of "SaaS".

  2. If the SKUs are tagged with an InventoryCheck prerequisite, check the inventory for a SKU.

    Note

    At this time, there are no commercial marketplace products that support inventory check or are tagged with an InventoryCheck prerequisite.

  3. Retrieve the availability for the SKU. You'll need the CatalogItemId of the availability when placing the order, which you can retrieve through the following APIs:

Create and submit an order

  1. Create a cart to hold the collection of catalog items that you intend to buy. When you create a cart, the cart line items are automatically grouped based on what can be purchased together in the same order. (You can also update a cart.)
  2. Check out the cart, which results in the creation of an order.

Get order details

You can retrieve the details of an individual order using the order ID. You can also retrieve a list of all orders for a specific customer.

Note

After an order is submitted, there is a delay of up to 15 minutes before the order appears in that customer's order list.

The partner or customer must activate subscriptions to Azure Marketplace products. You can get an activation link by order line item. You can also get a subscription by ID, then enumerate its Links property to create an activation link.

Lifecycle management

You can manage the lifecycle of your subscriptions to commercial marketplace products using the following methods:

Quantity management

The quantity of a commercial marketplace subscription must be within the limits defined by its associated SKU (see the minimumQuantity and maximumQuantity attributes). To update the quantity of a commercial marketplace subscription, use the following method:

Invoice and reconciliation

You can manage customer invoices (including charges for subscriptions to commercial marketplace products) using the following methods:

Sandbox environment

Marketplace isn't currently supported in the sandbox environment. There's no integration with ISVs, and it isn't possible to create a publisher, or test offers within sandbox. Additionally, Marketplace purchasing isn't enabled in sandbox. To test your offers, we recommend creating a "test offer" with a minimal amount and conducting the tests in the production environment.