SaaS fulfillment APIs in Microsoft commercial marketplace

The SaaS Fulfillment APIs enable publishers, also known as independent software vendors (ISVs), to publish and sell their SaaS applications in Microsoft AppSource, Azure Marketplace, and Azure portal. These APIs enable ISV applications to participate in all commerce enabled channels: direct, partner-led (reseller), and field-led. Integrating with these APIs is a requirement for creating and publishing a transactable SaaS offer in Partner Center.

ISVs must implement the following API flows by adding into their SaaS service code to maintain the same subscription status for both ISVs and Microsoft:

  • Landing page flow: Microsoft notifies the publisher that the publisher's SaaS offer has been purchased by a customer in the marketplace.
  • Activation flow: Publisher notifies Microsoft that a newly purchased SaaS account has been configured on the publisher's side.
  • Update flow: Change of purchased plan and/or the number of purchased seats.
  • Suspend and reinstate flow: Suspending the purchased SaaS offer in case the customer's payment method is no longer valid. The suspended offer can be reinstated when the issue with payment method is resolved.
  • Webhook flows: Microsoft will notify the publisher about SaaS subscription changes and cancellation triggered by the customer from Microsoft side.

For the cancellation of the purchased SaaS subscription, integration is optional, because it can be done by the customer from Microsoft side.

Correct integration with SaaS Fulfillment APIs is critical for making sure that

  • the end customers who purchased the publisher's SaaS offer are billed correctly by Microsoft.
  • the end customers are getting the correct user experience purchasing, configuring, using and managing SaaS subscriptions purchased in the Marketplace.

These APIs enable the publisher's offers to participate in all commerce enabled channels:

  • direct
  • partner-led (reseller, CSP)
  • field-led

In the reseller (CSP) scenario, a CSP is purchasing the SaaS offer on behalf of the end customer. A customer is expected to use the SaaS offer, but the CSP is the entity that does the following:

  • billing the customer
  • changing subscription plans/amount of purchased seats
  • canceling the subscriptions

The Publisher is not required to implement any of the API call flows differently for this scenario.

For more information about CSP, please refer to https://partner.microsoft.com/licensing.

Warning

The current version of this API is version 2, which should be used for all new SaaS offers. Version 1 of the API is deprecated and is being maintained to support existing offers.

Note

The SaaS fulfillment APIs are only intended to be called from a backend service of the publisher. Integration with the APIs directly from the publisher's web page is not supported. Only service-to-service authentication flow should be used.

Next steps

If you have not already done so, register your SaaS application in the Azure portal as explained in Register an Azure AD Application. Afterwards, use the most current version of this interface for development: SaaS Fulfillment API Version 2.