SaaS-Fulfillment-APIs im kommerziellen Microsoft-Marketplace

  • Artikel

Mit den SaaS-Fulfillment-APIs können Herausgeber – auch als unabhängige Softwarehersteller (Independent Software Vendors, ISVs) bezeichnet – ihre SaaS-Anwendungen in Microsoft AppSource, in Azure Marketplace und im Azure-Portal veröffentlichen und vertreiben. Mit diesen APIs können ISVs für ihre Anwendungen alle Handelskanäle nutzen: direkt, über Partner (Reseller) und über den Vertrieb. Die Integration dieser APIs ist eine Voraussetzung für das Erstellen und Veröffentlichen transaktionsfähiger SaaS-Angebote im Partner Center.

Wenn Sie mehr über die SaaS-Fulfillment-APIs erfahren möchten, empfehlen wir Ihnen, auch die folgenden Artikel zu lesen:

API-Flows

ISVs müssen die folgenden API-Flows implementieren und ihrem SaaS-Dienstcode hinzufügen, um sowohl für ISVs als auch für Microsoft denselben Abonnementstatus aufrechtzuerhalten:

  • Flow „Angebotsseite“: Microsoft benachrichtigt den Herausgeber, dass sein SaaS-Angebot von einem Kunden im Marketplace gekauft wurde.
  • Flow „Aktivierung“: Der Herausgeber benachrichtigt Microsoft, dass aufseiten des Herausgebers ein neu erworbenes SaaS-Konto konfiguriert wurde.
  • Flow „Aktualisierung“: Änderung des erworbenen Plans oder der Anzahl erworbener Arbeitsplätze oder beides.
  • Aussetzen und Wiedereinsetzen des Ablaufs: Das Aussetzen des erworbenen SaaS-Angebots für den Fall, dass die Zahlungsmethode des Kunden nicht mehr gültig ist. Das ausgesetzte Angebot kann reaktiviert werden, wenn das Problem mit der Zahlungsmethode behoben wurde.
  • Flows „Webhook“: Microsoft benachrichtigt den Herausgeber über Änderungen und Kündigungen des SaaS-Abonnements, die der Kunde bei Microsoft veranlasst hat.

Bei einer Kündigung des erworbenen SaaS-Abonnements ist die Integration optional, da sie vom Kunden aufseiten von Microsoft vorgenommen werden kann.

Die ordnungsgemäße Integration der SaaS-Fulfillment-APIs ist wichtig, um Folgendes zu gewährleisten:

  • Endkunden, die das SaaS-Angebot des Herausgebers erworben haben, werden ordnungsgemäß von Microsoft abgerechnet.
  • Endkunden profitieren beim Kauf, der Konfiguration, der Nutzung und der Verwaltung der im Marketplace erworbenen SaaS-Abonnements von einer reibungslosen Benutzererfahrung.

Mit diesen APIs kann der Herausgeber alle Handelskanäle für seine Angebote nutzen:

  • Direkt
  • Partner (Handelspartner, CSP)
  • Vertrieb

Im Szenario für Handelspartner (CSP) erwirbt ein CSP das SaaS-Angebot im Namen des Endkunden. Es wird davon ausgegangen, dass der Kunde das SaaS-Angebot nutzt, folgende Aufgaben aber in der Verantwortung des CSPs liegen:

  • Abrechnen des Kunden
  • Ändern von Abonnementplänen/der Anzahl erworbener Arbeitsplätze
  • Kündigen von Abonnements

Publisher ist nicht erforderlich, um einen der API-Aufrufflüsse für dieses Szenario anders zu implementieren.

Weitere Informationen zum CSP finden Sie unter https://partner.microsoft.com/licensing.

Warnung

Die aktuelle Version dieser API ist Version 2, die für alle neuen SaaS-Angebote verwendet werden sollte. Version 1 der API ist veraltet und wird zur Unterstützung vorhandener Angebote noch gepflegt.

Hinweis

Die SaaS-Fulfillment-APIs müssen ausschließlich von einem Back-End-Dienst des Herausgebers aufgerufen werden. Die direkte Integration mit den APIs von der Webseite des Herausgebers wird nicht unterstützt. Es sollte nur der Authentifizierungsflow von Dienst zu Dienst verwendet werden.

Nächste Schritte

Videoanleitungen