本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 將您的 SaaS 合約產品與 整合 AWS Marketplace
<a name="saas-integrate-contract"></a>

**新 SaaS 產品的整合需求將於 2026 年 6 月 1 日變更**  
AWS Marketplace 推出並行協議的支援，可在同一個協議期間對單一 AWS 帳戶多次購買相同的產品。從 2026 年 6 月 1 日開始，所有新的 SaaS 產品都需要支援更新的整合需求。[檢閱並行協議的新整合](https://catalog.workshops.aws/mpseller/en-US/saas/integration-for-concurrent-agreements)。

將您的軟體即服務 (SaaS) 合約產品與 整合 AWS Marketplace ，是 中的一個步驟[在 中建立 SaaS 產品 AWS Marketplace](saas-create-product.md)。若要將軟體即服務 (SaaS) 合約產品與 整合 AWS Marketplace，您必須撰寫程式碼，並示範它可以成功回應數個客戶案例。下列各節說明這些案例、說明如何回應這些案例，並提供測試整合的概觀。

**注意**  
開始之前，請確定您已為其中的軟體即服務 (SaaS) 產品選擇正確的定價模式 AWS Marketplace。如需詳細資訊，請參閱[規劃您的 SaaS 產品](saas-prepare.md)。

**Topics**
+ [案例：您的服務會驗證新客戶](#saas-contract-validate-customer)
+ [案例：您的服務處理客戶請求](#saas-contract-customer-requests)
+ [案例：監控使用者訂閱的變更](#saas-contract-monitor-changes)
+ [測試您的 SaaS 合約產品整合](#saas-contract-integration-testing)

## 案例：您的服務會驗證新客戶
<a name="saas-contract-validate-customer"></a>

當客戶訂閱您的產品時，它們會重新導向至您的註冊 URL，這是具有臨時`x-amzn-marketplace-token`字符的 HTTP POST 請求。以下列方式回應此請求：

1. 呼叫 中的 `[ ResolveCustomer](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_ResolveCustomer.html)` API 操作，`ProductCode`以交換 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 的字符 AWS Marketplace Metering Service**。

1. 透過呼叫 中的 `[ GetEntitlements](https://docs.aws.amazon.com/marketplaceentitlement/latest/APIReference/API_GetEntitlements.html)` API 操作，確認客戶可存取的訂閱和數量 （如適用） AWS Marketplace Entitlement Service。

1. `ProductCode` 在您的系統中保留 `CustomerIdentifier`、`LicenseArn`、 `CustomerAWSAccountId`和 以供日後呼叫。存放客戶是否擁有有效的訂閱，以及您需要的客戶相關資訊。

1. 為了回應請求，您必須顯示使用者的第一次使用體驗 （適用於您的服務）。

## 案例：您的服務處理客戶請求
<a name="saas-contract-customer-requests"></a>

當客戶對您的服務提出請求時，您必須以適當的動作或簡訊回應下列案例：
+ 它們在您的系統中沒有客戶 ID。這表示他們尚未訂閱。您應該告訴使用者如何訂閱。
+ 他們有客戶 ID，API `GetEntitlements`操作會傳回適當的權利。在此案例中，您應該完成請求。
+ 它們確實有客戶 ID，但 `GetEntitlements` API 操作不會傳回任何權利，或沒有足夠的數量來滿足請求。在此案例中，您必須決定如何處理存取和管理他們的體驗。

## 案例：監控使用者訂閱的變更
<a name="saas-contract-monitor-changes"></a>

**重要**  
正在以 Amazon EventBridge 通知取代 AWS Marketplace SaaS 產品的 SNS 通知。如果您有與 SNS 整合的現有 SaaS 產品，它們將繼續運作。新的清單最終將轉換為使用 Amazon EventBridge 而非 SNS。如需詳細資訊，請參閱[使用 Amazon EventBridge 管理 SaaS 訂閱事件](saas-eventbridge-integration.md)。

將 Amazon Simple Queue Service (Amazon SQS) 佇列設定為 Amazon EventBridge 規則的目標，以接收客戶權利變更的相關事件。當您建立產品時，已提供 Amazon EventBridge 事件組態。如需詳細資訊，請參閱[在 中建立 SaaS 產品 AWS Marketplace](saas-create-product.md)。透過設定 Amazon EventBridge 規則，您會收到客戶權利變更的相關事件，包括提供或撤銷特定客戶的存取權。

您必須回應的唯一通知是：
+ 授權已更新 Amazon EventBridge 事件 – 客戶權利已變更，您必須呼叫 `GetEntitlements` API 操作以查看新狀態。更新您的客戶商店，如果適用 （例如，客戶的合約已到期），請遵循關閉客戶資源的實務，並遵循您的保留政策。

**注意**  
如需其他資訊，請參閱 [使用 檢查權利 AWS Marketplace Entitlement Service](checking-entitlements.md)。

## 測試您的 SaaS 合約產品整合
<a name="saas-contract-integration-testing"></a>

將 SaaS 合約產品與 整合之後 AWS Marketplace，您必須進行深入測試，以確保整合成功。下列程序概述驗證產品整合的步驟。

**注意**  
使用您自己的帳戶訂閱您的產品，並測試整合是否成功。價格可以暫時降低，以便您可以測試購買流程，而不會在這些帳戶中產生高額費用。如需暫時降低價格或允許其他測試帳戶存取您產品的詳細資訊，[請聯絡我們](https://aws.amazon.com/marketplace/management/contact-us/)。  
啟動產品後，服務必須繼續回應新客戶的這些案例。

1. 使用允許的帳戶，透過取得您產品的合約來測試客戶體驗。

1. 帳戶簽訂合約後，請確定帳戶重新導向至註冊 URL，而且重新導向是包含臨時字符的 POST 請求。請確定您的應用程式保留客戶 ID 以供未來通話使用，並正確處理客戶擁有的權利。這會測試 的一部分[案例：您的服務會驗證新客戶](#saas-contract-validate-customer)。

1. 在上一個步驟中驗證測試帳戶後，將帳戶加入您的應用程式。例如，您可以讓測試客戶填寫表單來建立新的使用者。或者，提供他們存取 SaaS 應用程式的其他後續步驟。這會測試 的一部分[案例：您的服務會驗證新客戶](#saas-contract-validate-customer)。

1. 如果 `GetEntitlements` API 操作未傳回任何權利，無論是在加入期間或持續驗證通過時，您的應用程式都必須正確管理無權使用者的存取和體驗。這會測試 [案例：您的服務處理客戶請求](#saas-contract-customer-requests)。

1. 測試訂閱變更。確認您的應用程式正確處理取消訂閱、成功訂閱和失敗的訂閱案例。這會測試 [案例：監控使用者訂閱的變更](#saas-contract-monitor-changes)。

1. 在您完成所有整合要求並測試解決方案之後，請通知 AWS Marketplace 營運團隊。然後，他們會驗證您已成功呼叫 `GetEntitlements` API 操作並充分加入新客戶，以測試解決方案。

整合和測試完成後，您可以執行最終審核並在公開上列出您的產品 AWS Marketplace。如需詳細資訊，請參閱[在 中建立 SaaS 產品 AWS Marketplace](saas-create-product.md)。您也可以填寫退款申請表來取消測試訂閱。如需取消訂閱的詳細資訊，請參閱 [請求帳單調整 （退款）](refunds.md#refund-process)。