Microsoft コマーシャル マーケットプレースの SaaS Fulfillment API
SaaS Fulfillment API を使用すると、発行元 (独立系ソフトウェア ベンダー (ISV) とも呼ばれます) は、SaaS アプリケーションを Microsoft AppSource、Azure Marketplace、Azure portal と統合することができます。 これらの API により、ISV アプリケーションは、すべての商取引が有効になっているチャネル (直接、パートナー主導 (再販業者)、フィールド主導) に参加できるようになります。 これらの API との統合は、パートナー センターで取引可能な SaaS オファーを作成して公開するための要件です。
SaaS Fulfillment API の詳細については、次の記事も参照することをお勧めします。
- SaaS サブスクリプションのライフ サイクルの管理
- SaaS Fulfillment サブスクリプション API v2
- SaaS Fulfillment 操作 API v2
- SaaS サービスでの Webhook の実装
- SaaS フルフィルメント API に関する一般的な質問
API フロー
ISV と Microsoft の両方で同じサブスクリプションの状態を維持するために、ISV は次の API フローを SaaS サービス コードに追加することで実装する必要があります。
- ランディング ページ フロー: Microsoft は、パブリッシャーの SaaS オファーがマーケットプレースの顧客によって購入されたことをパブリッシャーに通知します。
- アクティブ化フロー: パブリッシャーは、新しく購入した SaaS アカウントがパブリッシャー側で構成されたことを Microsoft に通知します。
- 更新フロー: 購入したプランの変更、または購入したシートの数、またはその両方。
- フローの中断と再開: 顧客の支払い方法が無効になった場合に備え、購入した SaaS オファーを中断します。 支払い方法に関する問題が解決されると、中断されたオファーを再開できます。
- Webhook フロー: Microsoft は、顧客によってトリガーされた SaaS サブスクリプションの変更と取り消しについて、Microsoft 側からパブリッシャーに通知します。
購入した SaaS サブスクリプションを解約する場合、統合は、Microsoft 側の顧客で行うことができるため、省略可能です。
SaaS Fulfillment API との統合を正しく行うことは、次を保証するために非常に重要です。
- 発行元の SaaS オファーを購入したエンド カスタマーが、Microsoft から正しく請求されること。
- エンド カスタマーが、マーケットプレースで購入した SaaS サブスクリプションを購入、構成、使用、および管理する際に適切なユーザー エクスペリエンスが得られていること。
これらの API を使用すると、発行元のオファーをすべてのコマース対応チャネルに参加させることができます。
- 直接
- パートナー主導 (リセラー、クラウド ソリューション プロバイダー [CSP])
- フィールド主導
リセラー (CSP) シナリオでは、CSP がエンド ユーザーに代わって SaaS オファーを購入します。 顧客は SaaS オファーを使用することが見込まれますが、CSP は次のタスクを行うエンティティです。
- 顧客に請求する
- サブスクリプション プランまたは購入したシート数を変更する
- サブスクリプションを取り消す
パブリッシャーは、このシナリオで異なる方法で API 呼び出しフローを実装する必要はありません。
詳細については、「クラウド ソリューション プロバイダー (CSP)」を参照してください。
警告
SaaS Fulfillment API バージョン 1 は非推奨になりました。代わりに、V2 を使用します。 V1 は現在、既存のパブリッシャーにサービスを提供するためにのみ保守されており、V1 のドキュメントは使用できなくなりました。 アクセスする必要があると感じる場合は、 saas-api-v1@microsoft.com電子メールで送信できます。
Note
SaaS Fulfillment API は、発行元のバックエンド サービスから呼び出すことのみを目的としています。 パブリッシャーの Web ページから直接 API との統合はサポートされていません。 サービス間認証フローのみを使用する必要があります。
関連するコンテンツ
- まだ登録していない場合は、「 Microsoft Entra アプリケーションの登録」で説明されているようにAzure ポータルに SaaS アプリケーションを登録。 その後、開発に次のインターフェイスの最新バージョンを使用します。SaaS Fulfillment サブスクリプション API v2 および SaaS Fulfillment 操作 API v2。
ビデオ チュートリアル