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:

  • Angebotsfluss: Microsoft benachrichtigt den Herausgeber, dass das SaaS-Angebot des Herausgebers von einem Kunden auf dem Marketplace erworben wurde.
  • Aktivierungsablauf: Publisher benachrichtigt Microsoft, dass ein neu erworbenes SaaS-Konto auf der Herausgeberseite konfiguriert wurde.
  • Updatefluss: Änderung des gekauften Plans oder die Anzahl der erworbenen 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.
  • Webhook-Flüsse: Microsoft benachrichtigt den Herausgeber über SaaS-Abonnementänderungen und -stornierungen, die vom Kunden von der Microsoft-Seite ausgelöst werden.

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
  • Partnergeführt (Händler, Cloud Solution Provider [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 finden Sie unter Azure Cloud Solution Provider (CSP).

Warnung

SaaS-Erfüllungs-APIs, Version 1, wurden veraltet; Verwenden Sie stattdessen V2. V1 wird derzeit nur für vorhandene Herausgeber verwaltet, und die Dokumentation für V1 ist nicht mehr verfügbar. Wenn Sie der Meinung sind, dass Sie darauf zugreifen müssen, können Sie eine E-Mail senden saas-api-v1@microsoft.com.

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.

Zugehöriger Inhalt

Videoanleitungen