管理 SaaS 訂用帳戶生命週期
商業市集在用戶購買 SaaS 訂用帳戶之後，會管理整個生命週期。 它會使用登陸頁面、履行 API、作業 API 和 Webhook 作為機制，以驅動實際的 SaaS 訂用帳戶啟用、使用量、更新和取消。 用戶的帳單是以Microsoft維護的 SaaS 訂用帳戶狀態為基礎。
SaaS 訂用帳戶的狀態
下圖顯示 SaaS 訂用帳戶的狀態和適用的動作。
已購買但尚未啟動 （PendingFulfillmentStart）
在使用者或雲端解決方案提供者 （CSP） 在商業市集中購買 SaaS 供應專案之後，發行者會收到購買通知。 然後，發行者可以在終端用戶的發行者端建立及設定新的 SaaS 帳戶。
若要建立帳戶，請執行：
- 客戶在 AppSource 或 Microsoft Azure 入口網站 成功購買 SaaS 供應項目之後，選取 [立即設定帳戶] 按鈕。 或者，客戶可以使用 購買后不久收到的電子郵件中的 [立即 設定] 按鈕。
- Microsoft接著在新的瀏覽器索引標籤中，開啟登陸頁面 URL 與令牌參數（來自商業市集的購買識別令牌）來通知合作夥伴購買。
這類呼叫的範例是 https://contoso.com/signup?token=<blob>，但合作夥伴中心內此 SaaS 供應專案的登陸頁面 URL 會設定為 https://contoso.com/signup。 此令牌會為發行者提供可唯一識別 SaaS 購買和客戶的標識碼。
提示
請勿在登陸頁面 URL 中包含井字號的字元 (#)。 否則，客戶將無法存取您的登陸頁面。
重要
登陸頁面 URL 必須全天啟動並執行，並準備好隨時接收來自Microsoft的新呼叫。 如果登陸頁面變成無法使用，客戶將無法註冊 SaaS 服務並開始使用它。
接下來，發行者必須藉由呼叫 SaaS 解析 API，並將令牌輸入為 參數的值x-ms-marketplace-token header，將令牌傳回Microsoft。 由於解析 API 呼叫的結果，令牌會交換，以取得 SaaS 購買的詳細數據，例如購買的唯一標識碼、購買的供應專案標識碼和購買的方案標識碼。
在登陸頁面上，客戶應該透過 Microsoft Entra 單一登錄 （SSO） 登入新的或現有的 SaaS 帳戶。
注意
在客戶從Microsoft端起始設定程式之前，發行者將不會收到 SaaS 購買的通知。
發行者應該實作 SSO，以提供此流程Microsoft所需的用戶體驗。 設定 SSO 時，請務必使用多租使用者Microsoft Entra 應用程式，並允許公司與學校帳戶或個人Microsoft帳戶。 這項需求僅適用於登陸頁面，適用於已使用Microsoft認證登入時，重新導向至 SaaS 服務的使用者。 所有登入 SaaS 服務都不需要 SSO。
注意
如果 SSO 要求系統管理員必須授與應用程式的許可權，合作夥伴中心中的供應專案描述必須揭露需要系統管理員層級的存取權。 這項披露是符合 商業市集認證原則。
登入之後，客戶應該會在發行者端完成 SaaS 設定。 然後，發行者必須呼叫 啟動訂用帳戶 API ，以將訊號傳送給 Azure Marketplace，指出 SaaS 帳戶的布建已完成。 此動作會啟動客戶的計費週期。 如果啟動訂用帳戶 API 呼叫未成功，則不會向客戶收取購買費用。
購買者和計費帳戶擁有者都會收到一封電子郵件，要求他們設定帳戶。
注意
當狀態為 PendingFulfillmentStart 時，發行者有 30 天的時間可解決資產，否則資產將會是無效的，因為未起始計費週期，而且不會針對個別購買計費，狀態將會變更為 [未訂閱]。 客戶不會支付購買費用。
使用中 （已訂閱）
作用中 （已訂閱） 是已布建 SaaS 訂用帳戶的穩定狀態。 在Microsoft端處理啟用訂用帳戶 API 呼叫之後，SaaS 訂用帳戶會標示為 [已訂閱]。 客戶現在可以在發行者端使用 SaaS 服務，並計費。
當 SaaS 訂用帳戶已作用中時，客戶可以從 Azure 入口網站 或 Microsoft 365 系統管理 中心選取 [管理 SaaS 體驗]。 此動作也會讓Microsoft使用 Token 參數呼叫登陸頁面 URL，就像在 Activate 流程中一樣。 發行者應區分新購買與現有 SaaS 帳戶的管理，並據以處理此登陸頁面 URL 呼叫。
啟用通知電子郵件會同時傳送給購買者和計費帳戶擁有者。
正在更新 （已訂閱）
此動作表示Microsoft和發行者正在處理現有作用中 SaaS 訂閱的更新。 這類更新可以由下列方式起始：
- 來自商業市集的客戶。
- 來自商業市集的 CSP。
- 來自發行者 SaaS 網站的客戶（但不適用於 CSP 進行購買）。
SaaS 訂用帳戶有兩種類型的更新：
- 客戶選擇訂用帳戶的另一個方案時更新方案。
- 當客戶變更訂閱的已購買授權數目時，更新數量。
只能更新作用中的訂用帳戶。 在更新訂閱時，其狀態會維持在Microsoft端。
從商業市集起始的更新
在此流程中，客戶會從 Azure 入口網站 或 Microsoft 365 系統管理 中心變更訂閱方案或授權數量。
- 輸入更新之後，Microsoft會呼叫發行者的 Webhook URL，並在合作夥伴中心的 [技術設定] 頁面上的 [連線 Webhook] 欄位中設定，並具有動作和其他相關參數的適當值。
- 發行者端應該對 SaaS 服務進行必要的變更，並藉由呼叫 作業 API 的更新狀態，在完成時通知Microsoft。
- 如果修補程式傳送失敗狀態，更新程式將無法在Microsoft端完成。 SaaS 訂用帳戶會保留現有的方案和授權數量。
注意
發行者應該叫用 PATCH，以在收到 Webhook 通知之後，於 10 秒內更新失敗/成功回應的作業 API 狀態。 如果在 10 秒內未收到作業狀態 PATCH，則變更計劃 會自動修補為成功。
下圖顯示從商業市集起始之更新案例的 API 呼叫順序。
從發行者起始的更新
在此流程中，客戶會變更從 SaaS 服務本身購買的訂用帳戶方案或授權數量。
- 在發行者端提出要求的變更之前，發行者程式代碼必須呼叫變更方案 API 或變更數量 API 或兩者。
- Microsoft會將變更套用至訂用帳戶，然後透過 連線 Webhook 通知發行者以套用相同的變更。
- 只有當發行者對 SaaS 訂用帳戶進行必要的變更，並藉由呼叫 作業 API 的更新狀態來通知Microsoft變更。
下圖顯示從發行者端起始之更新案例的 API 呼叫順序。
指出方案變更的通知電子郵件會同時傳送給購買者和計費帳戶擁有者。
指出數量變更的通知電子郵件會同時傳送給購買者和計費帳戶擁有者。
暫停（暫停）
此狀態表示客戶未收到 SaaS 服務的付款。 Microsoft會在 SaaS 訂用帳戶狀態中通知發行者此變更。 通知是透過呼叫 Webhook 來完成， 動作 參數設定為 Suspended。
發行者可能會或可能不會對發行者端的 SaaS 服務進行變更。 我們建議發行者將此資訊提供給暫停的客戶使用，並限制或封鎖客戶的 SaaS 服務存取權。 付款永遠不會收到的可能性。
注意
Microsoft為客戶提供 30 天的寬限期，再自動取消訂用帳戶。 超過 30 天的寬限期之後，Webhook 將會收到動作 Unsubscribe 。
當訂用帳戶處於 暫停 狀態時：
- 合作夥伴或ISV必須讓SaaS帳戶保持可復原狀態，以便還原完整功能，而不會遺失數據或設定。
- 如果寬限期期間收到付款，或要求在寬限期結束時取消布建訂閱，合作夥伴或ISV應預期要求會恢復訂閱。 這兩個要求都會透過 Webhook 機制傳送。
在發行者採取任何動作之前，訂用帳戶狀態會在Microsoft端變更為 [暫停]。 只有作用中的訂用帳戶可以暫停。
通知電子郵件，指出狀態變更為「已暫停」，將會同時傳送給購買者和計費帳戶擁有者。
在暫停 30 天之後，系統會將有關暫停後取消的電子郵件傳送給購買者和計費帳戶擁有者。
回復（暫停）
此動作表示客戶的付款方式已再次生效、已針對 SaaS 訂用帳戶進行付款，以及正在恢復訂閱。 在此案例中：
- Microsoft呼叫 Webhook，並將 動作 參數設定為 Reinstate 值。
- 發行者可確保訂閱在發行者端再次完全運作。
- 恢復程式成功，且客戶會針對 SaaS 訂用帳戶再次計費。
只能恢復暫停的訂用帳戶。 暫停的 SaaS 訂用帳戶在恢復時仍處於 暫停 狀態。 完成此作業之後，訂用帳戶的狀態將會變成 作用中。
在從暫停狀態轉換為恢復狀態之後，系統會將電子郵件傳送給購買者和帳單擁有者。
已續約 （已訂閱）
SaaS 訂用帳戶會在一個月或一年訂閱期限結束時自動更新Microsoft。 所有 SaaS 訂用帳戶的自動續約設定預設值為 true 。 使用中的 SaaS 訂用帳戶將繼續定期更新。 Microsoft提供更新事件的僅限通知 Webhook 通知。 客戶可以透過 Microsoft 365 系統管理 入口網站關閉 SaaS 訂用帳戶的自動更新。 在此情況下，SaaS 訂用帳戶將會在目前計費期限結束時自動取消。 客戶也可以隨時取消 SaaS 訂用帳戶。
只有作用中的訂用帳戶會自動更新。 訂閱會在續約程式期間保持作用中，如果自動更新成功，則為 。 續約之後，訂閱字詞的開始和結束日期會更新為新詞彙的日期。
如果自動續約因付款問題而失敗，訂用帳戶將會變成 「暫停 」，且發行者會收到通知。
更新的提醒電子郵件將會同時傳送給購買者和計費帳戶的擁有者，在年度/多年續約日期之前的 30 天。
取消 （ 未訂閱 ）
訂閱會透過從發行者網站、Azure 入口網站 或 Microsoft 365 系統管理 中心取消訂用帳戶，以響應明確的客戶或 CSP 動作，達到此狀態。 訂閱也可以在暫停狀態 30 天后隱含取消，因為未支付到期費用。
在發行者收到取消 Webhook 呼叫之後，他們應保留客戶數據，以要求至少七天進行復原。 只有這樣，客戶數據才能刪除。
SaaS 訂用帳戶可以在其生命週期的任何時間點取消。 取消訂閱之後，就無法重新啟用。
取消電子郵件會同時傳送給購買者和計費帳戶的擁有者。
相關內容
影片教學課程