關於訂閱項目

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本文將說明如何處理訂閱的生命週期事件，例如續訂和到期日。同時也會說明訂閱服務的其他功能，例如提供促銷活動和允許使用者自行管理訂閱項目。

如果您尚未設定應用程式的訂閱產品，請參閱「建立並設定產品」。

訂閱總覽

「訂閱項目」是指會定期產生交易，並向使用者授予特定授權的項目。授權代表使用者在指定期間內可以享有的一系列權益。例如，訂閱項目可能會授權使用者存取付費內容。

您可以透過「基本方案」和「優惠方案」為同一項訂閱產品建立多項設定。例如，您可以為從未訂閱應用程式的使用者建立新用戶優惠。同樣地，您也可以為已訂閱的使用者建立升級優惠。

如需訂閱產品、基本方案和優惠方案的詳細總覽，請參閱 Play 管理中心的說明中心文件。

Play 帳款服務程式庫支援下列訂閱類型：

• 單一項目訂閱 - 在這種情況下，一個項目對應一個授權。例如訂閱音樂串流服務。

• 含外掛項目的訂閱方案：在這種情況下，單筆交易可包含多項不同授權的組合。例如同時訂閱音樂串流服務和影片訂閱服務。如需附加購項目訂閱項目的相關資訊，請參閱「附加購項目訂閱項目」。

預付方案整合

預付方案不會在到期後自動續訂。如要在不中斷的情況下延長訂閱授權，使用者必須為同一訂閱項目的預付方案「儲值」。

如要儲值，請依照原始購買交易啟動帳單流程。您不必表明購買交易方式為儲值。

預付方案儲值一律會採用 CHARGE_FULL_PRICE 替代模式，因此不需明確設定此模式。系統會立即向使用者收取完整帳單週期的費用，並將授權效期延長至儲值指定的期限。

儲值之後，Purchase 結果物件中的下列欄位會更新，以反映最近一次儲值購買交易：

• 訂單 ID
• 購買時間
• 簽章
• 購買憑證
• 已確認

下列 Purchase 欄位一律包含原始購買交易中的相同資料：

• 套件名稱
• 購買狀態
• 產品
• 自動續訂

預付購買確認

與自動續訂訂閱項目類似，您必須在購買後確認預付方案。初次購買和所有儲值作業都需要獲得確認。詳情請參閱處理購買交易一文。

由於預付方案的持續時間可能比較短，請務必盡快確認購買交易。

預付期為一週或以上的預付方案必須在三天內確認。

預付期少於一週的預付方案必須在方案效期的一半時間內確認。例如，對於為期三天的預付方案，開發人員有 1.5 天的時間來進行確認。

分期付款訂閱項目整合

分期付款訂閱是一種訂閱類型，使用者可以在一段時間內分期付款，而非預先支付整筆訂閱費用。

分期付款訂閱方案的其他注意事項：

• 適用國家/地區：分期付款訂閱功能僅適用於巴西、法國、義大利和西班牙 (請查看管理中心的最新資訊)。
• 設定價格：在管理中心設定分期付款訂閱方案的價格時，價格代表每月付款金額。這項資訊與設定的承諾期結合後，就會在購買畫面中產生訂閱項目的總金額。
• 承諾期：初始訂閱承諾的總時間長度，在這段期間內，你必須每月支付費用。舉例來說，如果基本方案有 15 個月的承諾期，使用者將在這段期間支付 15 次月費。
• 續約：在分期付款訂閱方案中，「續約」表示結束承諾期，可能是初始承諾期或後續承諾期。初始註冊後，系統會在初始約期結束時進行首次續約。後續續約會在每個後續承諾期滿後進行。分期付款訂閱項目的續訂類型可以是「每月自動續訂」或「自動續訂相同時長」。如果是「按月自動續訂」，則沒有後續承諾，且方案的運作方式就像月費訂閱，每筆月費訂閱費用都會視為續約。
• 帳單週期：在分期付款訂閱項目的情況下，這是指在基本方案中指定的個別付款項目定期間隔。
• 變更方案與價格異動行為：對於價格異動和取消訂單，我們會堅守承諾。也就是說，如果使用者想取消訂閱或開發人員想變更價格，變更會在承諾期結束時生效。對於方案變更，我們無法提供明確的承諾。也就是說，訂閱方案變更不必等到承諾期結束才生效，而是會根據設定的取代模式，立即生效或在下次付款日生效。
• 同一個訂閱項目的方案變更：不允許將同一個訂閱產品的分期付款基本方案變更為非分期付款基本方案。

• 即時開發人員通知 (RTDN)：當使用者在承諾期間內仍需支付款項時，系統會立即傳送 SUBSCRIPTION_CANCELLATION_SCHEDULED RTDN。取消作業處於待處理狀態，只有在承諾期結束時才會生效。然後，如果使用者未恢復，系統會在承諾期結束時傳送 SUBSCRIPTION_CANCELED 和 SUBSCRIPTION_EXPIRED RTDN。

• 撥款 / 實現收益：使用者每月付款後，我們才會將款項撥付給開發人員，並遵循與其他所有訂閱項目相同的條款。使用者申請分期付款訂閱方案時，開發人員不會預先收到費用。

• 未收取的付款：如果使用者未支付任何分期付款訂閱項目，Google 和開發人員都不會嘗試向使用者收取這類未支付或未付款項，但 Google 可能會在適用的寬限期或帳戶保留期間，依照其一般付款重試做法定期重試收取款項。Google 對開發人員未支付的任何分期付款，概不負責。

• Play 帳款服務程式庫適用情形：installmentDetails 欄位僅適用於 PBL 7 以上版本。在 PBL 5 以上版本中，系統會使用 queryProductDetails() 傳回分期付款訂閱項目，但訂閱項目不會包含詳細的分期付款資訊，例如方案的已承諾付款次數。

利用深層連結允許使用者管理訂閱項目

應用程式應在設定或偏好設定畫面中提供連結，讓連結能融入應用程式的自然外觀和風格，方便使用者管理訂閱項目。

您可以使用訂閱資源的 subscriptionState 欄位判斷各訂閱項目是否過期，並且在應用程式加入深層連結，指向 Google Play 訂閱中心的未過期訂閱項目。 基於上述情況，您可以透過幾種方式加入 Play 商店訂閱中心的深層連結。

連結至訂閱中心

使用下列網址，將使用者導向至顯示所有訂閱項目的頁面，如圖 1 和圖 2 所示：

https://play.google.com/store/account/subscriptions

使用者可以透過這個深層連結，從 Play 商店訂閱中心還原已取消的訂閱項目。

連結至特定訂閱管理頁面 (建議做法)

如要直接連結至未過期訂閱項目的管理頁面，請指出與購買訂閱項目相關聯的套件名稱和 productId。如要透過程式判斷現有訂閱項目的 productId，請查詢應用程式的後端或呼叫 BillingClient.queryPurchasesAsync()，取得與特定使用者相關的訂閱項目清單。每個訂閱項目的訂閱狀態資訊都會包含對應的 productId。與訂閱購買交易相關聯的每個 SubscriptionPurchaseLineItem 物件都包含 productId 值，該值與使用者在該明細項目中購買的訂閱項目相關聯。

使用下列網址將使用者導向至特定訂閱管理畫面 (請將「your-sub-product-id」和「your-app-package」分別替換為 productId 和應用程式套件名稱)：

https://play.google.com/store/account/subscriptions?sku=your-sub-product-id&package=your-app-package

接著，使用者就能管理付款方式和存取功能，包括取消、重新訂閱和暫停。

允許使用者升級、降級或變更訂閱項目

您可以為現有訂閱者提供多種選項，讓他們根據需求變更訂閱方案：

• 如果您販售多個訂閱層級 (例如「基本級」和「進階級」訂閱項目)，則可讓使用者購買不同訂閱項目的基本方案或優惠，藉此轉換層級。
• 您可以讓使用者變更目前的帳單週期，例如從月費方案改成年繳方案。
• 您也可以允許使用者切換自動續訂或預付方案。

您可以提供訂閱優惠，為合格使用者提供折扣，鼓勵上述任何變動。例如，您可以建立一項優惠，在從月費方案改成年繳方案時提供第一年 50% 折扣，並且將這項優惠僅提供給訂閱月費方案但尚未購買這項優惠的使用者。如要進一步瞭解優惠資格條件，請前往說明中心。

圖 3 顯示包含三種不同方案的範例應用程式：

應用程式可以顯示與圖 3 類似的畫面，為使用者提供變更訂閱項目的選項。無論是哪種情況，您都應該讓使用者清楚瞭解目前的訂閱方案內容，以及可供變更的選項。

使用者決定升級、降級或變更訂閱項目時，您可以指定「取代模式」，決定如何套用目前付費帳單週期的按比例計費價值，以及任何授權變更的生效時間。

取代模式

下表列出可用的取代模式和使用範例，以及視為已付款的付款次數。

如要進一步瞭解如何將升級或降級優惠應用在各種向上銷售和挽回活動上，請參閱優惠與促銷活動指南。

設定購買交易的取代模式

您可以根據偏好設定和商業邏輯，針對不同的訂閱轉換類型使用不同的取代模式。本節說明如何為訂閱項目變更設定取代模式，以及適用的限制。

在同一訂閱項目內重新訂閱或切換方案

您可以在 Google Play 管理中心指定預設替代模式。如果現有訂閱者購買同一訂閱項目的不同基本方案或優惠，或是在取消訂閱後重新訂閱，您可利用這項設定選擇向他們收取費用的時間。可用選項包括「立即收費」(相當於 CHARGE_FULL_PRICE) 和「在下個結帳日收費」(相當於 WITHOUT_PRORATION)。在同一訂閱項目中切換基本方案時，這些是唯一相關的替代模式。

舉例來說，如果使用者在訂閱到期前取消訂閱，而您要針對同一個方案實作挽回優惠，可以將新購買交易視為一般購買交易處理，不必在 SubscriptionUpdateParams 中指明任何值。系統會採用您在訂閱項目中設定的預設取代模式，並自動處理從舊購買交易至新購買交易的方案轉換作業。

在不同訂閱項目間切換方案，或是覆寫預設取代模式

如果使用者要變更訂閱的產品 (也就是購買不同的訂閱項目)，或是您想基於任何理由覆寫預設取代模式，可以透過購買流程參數在「執行階段」指定依比例計費的比率。

如要在執行階段購買流程設定中正確提供 SubscriptionUpdateParams，請注意下列限制：

• 從預付方案、自動續約型方案或分期付款方案升級、降級或將相同訂閱項目切換至預付方案時，唯一允許的取代模式為 CHARGE_FULL_PRICE。如果指定任何其他替換模式，購買交易就會失敗，使用者也會看到錯誤訊息。
• 在同一訂閱項目內，從預付方案或自動續約型方案切換至自動續約型方案時，有效的依比例計費模式為 CHARGE_FULL_PRICE 和 WITHOUT_PRORATION。如果指定任何其他依比例計費模式，購買交易就會失敗，使用者也會看到錯誤訊息。
• 在同一個訂閱產品中，不允許從分期付款基本方案切換至非分期付款基本方案。

取代模式的範例和行為

若要瞭解各種依比例計費模式的運作方式，請考慮下列情境：

Samwise 訂閱了 Country Gardener 應用程式的線上內容，按月訂閱第 1 層級純文字內容版本。這個訂閱項目的費用為「每月 $2 美元」，並於每月第一天續訂。

4 月 15 日，Samwise 選擇升級為按年訂閱的第 2 層級版本，內容包含影片更新，費用為每年 $36 美元。

升級該訂閱項目時，開發人員需選取依比例計費模式。以下清單說明各種依比例計費模式對 Samwise 訂閱項目的影響：

WITH_TIME_PRORATION

Samwise 的第 1 層級訂閱會立即結束。由於他支付了全額月費 (4 月 1 日至 30 日)，但在訂閱期間中途進行了升級，因此半個月的訂閱費用 ($1 美元) 會套用到新訂閱項目。不過，由於新訂閱項目的費用為每年 $36 美元，1 美元的抵免餘額只能用於支付 10 天的費用 (4 月 16 日至 25 日)，因此在 4 月 26 日，系統會針對新訂閱項目向他收取 $36 美元的費用，之後每年的 4 月 26 日再收取 $36 美元。

您應在購買交易成功時呼叫應用程式的 PurchasesUpdatedListener，這樣就能透過 queryPurchasesAsync() 呼叫擷取新的購買交易。您的後端會立即收到 SUBSCRIPTION_PURCHASED 即時開發人員通知。

CHARGE_PRORATED_PRICE

您可以使用這種模式，因為第 2 層級每個時間單位的訂閱價格 (每年 $36 美元 = 每月 $3 美元) 高於第 1 層級每個時間單位的訂閱價格 (每月 $2 美元)。Samwise 的第 1 層級訂閱會立即結束。由於他已支付全額月費，但只使用了一半時間，因此半個月的訂閱費用 ($1 美元) 會套用到新的訂閱項目。不過，由於新訂閱項目的費用為每年 $36 美元，剩餘 15 天的費用為 $1.50 美元，因此系統會針對新訂閱項目向他收取 $0.50 美元的差額。系統會在 5 月 1 日針對新的訂閱層級向 Samwise 收取 $36 美元，並在之後每年的 5 月 1 日再收取 $36 美元。

您應在購買交易成功時呼叫應用程式的 PurchasesUpdatedListener，這樣就能透過 queryPurchasesAsync() 呼叫擷取新的購買交易。您的後端會立即收到 SUBSCRIPTION_PURCHASED 即時開發人員通知。

WITHOUT_PRORATION

Samwise 的第 1 層級訂閱會立即免費升級為第 2 層級，系統會在 5 月 1 日針對新的訂閱層級向他收取 $36 美元，之後每年的 5 月 1 日再收取 $36 美元。

您應在購買交易成功時呼叫應用程式的 PurchasesUpdatedListener，這樣就能透過 queryPurchasesAsync() 呼叫擷取新的購買交易。您的後端會立即收到 SUBSCRIPTION_PURCHASED 即時開發人員通知。

DEFERRED

Samwise 的第 1 層級訂閱繼續有效，直到 4 月 30 日到期為止。5 月 1 日，第 2 層級訂閱生效，系統會針對新的訂閱層級向 Samwise 收取 $36 美元。

您應在購買交易成功時呼叫應用程式的 PurchasesUpdatedListener，這樣就能透過 queryPurchasesAsync() 呼叫擷取新的購買交易。您的後端會立即收到 SUBSCRIPTION_PURCHASED 即時開發人員通知。屆時，處理購買交易的方式應與處理其他新購買交易時相同。具體而言，請務必確認這筆新購買交易。請注意，取代模式生效時 (也就是舊訂閱項目到期時)，系統會填入新訂閱項目的 startTime。屆時，您會收到新訂閱方案的 SUBSCRIPTION_RENEWED RTDN。如要進一步瞭解 ReplacementMode.DEFERRED 行為，請參閱「處理延遲取代模式」一節。

CHARGE_FULL_PRICE

Samwise 的第 1 層級訂閱會立即結束。他的第 2 層級訂閱將於今天開始生效，並須支付 $36 美元的費用。由於他已支付全額月費，但只使用了一半時間，因此半個月的訂閱費用 ($1 美元) 會套用到新的訂閱項目。由於新訂閱項目的費用為每年 $36 美元，因此訂閱期可再加上一年的 1/36 (約 10 天)。因此，下次向 Samwise 收費的時間為從今天起 1 年 10 天後，費用為 $36 美元。之後，系統每年會收取 $36 美元的費用。

選擇依比例計費模式時，請務必查看我們的「取代模式建議」。

觸發應用程式內訂閱項目異動

應用程式可以使用與「啟動購買流程」相同的步驟，向使用者提供升級或降級服務。不過，在升級或降級時，您需要提供目前訂閱項目、未來 (升級或降級後) 訂閱項目的詳細資料，以及要使用的取代模式等內容，範例如下：

val offerToken = productDetails
        .getSubscriptionOfferDetails(selectedOfferIndex)
        .getOfferToken()

val billingParams = BillingFlowParams.newBuilder().setProductDetailsParamsList(
       listOf(
           BillingFlowParams.ProductDetailsParams.newBuilder()
               .setProductDetails(productDetails)
               .setOfferToken(offerToken)
               .build()
       )
       ).setSubscriptionUpdateParams(
           BillingFlowParams.SubscriptionUpdateParams.newBuilder()
               .setOldPurchaseToken("old_purchase_token")
               .setSubscriptionReplacementMode(
                 BillingFlowParams.ReplacementMode.CHARGE_FULL_PRICE
               )
               .build()
       ).build()

billingClient.launchBillingFlow(
    activity,
    billingParams
   )
// ...

String offerToken = productDetails
    .getSubscriptionOfferDetails(selectedOfferIndex)
    .getOfferToken();

BillingFlowParams billingFlowParams = BillingFlowParams.newBuilder()
    .setProductDetailsParamsList(
        ImmuableList.of(
            ProductDetailsParams.newBuilder()
                // fetched via queryProductDetailsAsync
                .setProductDetails(productDetails)
                // offerToken can be found in
                // ProductDetails=>SubscriptionOfferDetails
                .setOfferToken(offerToken)
                .build()))
    .setSubscriptionUpdateParams(
        SubscriptionUpdateParams.newBuilder()
            // purchaseToken can be found in Purchase#getPurchaseToken
            .setOldPurchaseToken("old_purchase_token")
            .setSubscriptionReplacementMode(ReplacementMode.CHARGE_FULL_PRICE)
            .build())
    .build();

BillingResult billingResult = billingClient.launchBillingFlow(activity, billingFlowParams);
// ...

取代模式建議

下表列出依比例計費的不同情境，以及我們針對每個情境的建議做法：

處理訂閱項目異動購買交易

就所有條款和用途而言，方案的變更應視為新購買交易，且在帳單流程成功完成後以此方式處理及確認。除了妥善處理新購買交易，您也必須終止要取代的購買交易。

應用程式內行為與任何新購買交易相同。應用程式可在 PurchasesUpdatedListener 中收到新購買交易的結果，並使用 queryPurchasesAsync 中的新購買交易。

如果有購買交易取代現有購買交易，Google Play Developer API 會在訂閱資源中傳回 linkedPurchaseToken。請務必讓 linkedPurchaseToken 中提供的憑證失效，確保舊的憑證無法用來存取服務。請參閱「升級、降級和重新註冊」相關說明，瞭解如何處理升級和降級購買交易。

收到新的購買憑證後，請執行與驗證新的購買憑證相同的驗證程序。請務必透過 Google Play 帳款服務程式庫的 BillingClient.acknowledgePurchase() 或 Google Play Developer API 的 Purchases.subscriptions:acknowledge 確認這些購買交易。

處理延遲取代模式

延遲取代模式可讓使用者在開始新方案前，先用完舊方案的剩餘授權。

如果針對新購買交易使用 ReplacementMode.DEFERRED，queryPurchasesAsync() 會在購買流程後傳回新的購買憑證，該購買憑證仍保留與舊產品的關聯性，直到下一個續訂日期延遲取代模式生效後，系統才會傳回新產品。

過去，您可以透過已淘汰的 ProrationMode.DEFERRED 實現這項使用者體驗，但 ProrationMode.DEFERRED 已從 Play 帳款服務程式庫第 6 版淘汰。請參閱下表，瞭解兩者的行為差異：

從此應使用 ReplacementMode.DEFERRED 而非已淘汰的 ProrationMode.DEFERRED，因為前者雖然執行與授權變更相同的行為，但提供的購買交易管理方式，與其他新購買交易的行為更加一致。

客戶管理

在使用即時開發人員通知下，您可以即時得知使用者何時決定取消訂閱。假如使用者在到期前取消訂閱，您可以傳送推播通知或應用程式內通訊訊息，請求使用者重新訂閱。

使用者取消訂閱項目後，您可以嘗試在應用程式中或透過 Play 商店挽回使用者。下表說明各種訂閱情境，以及相關的挽回動作和應用程式相關規定。

訂閱到期前 - 應用程式內

對於已取消但尚未到期的訂閱項目，您可以採取與新訂閱者相同的應用程式內產品購買流程，讓訂閱者還原應用程式中的訂閱項目。請確認 UI 會反映出使用者已有訂閱項目。例如，您可以考慮在「重新啟用」按鈕旁顯示使用者目前的到期日和定期費用。

在多數情況下，您應考慮向使用者提供與其訂閱項目相同的價格和 SKU，方法如下：

• 購買 SKU 相同的新訂閱項目。
• 新訂閱項目會取代舊訂閱項目，並於相同的到期日續訂。舊訂閱項目會立即標示為「已過期」。
• 例如，Achilles 訂閱了 Example Music 應用程式，訂閱將於 8 月 1 日到期。7 月 10 日，他又重新訂閱了單月訂閱方案，每個月的價格不變。新訂閱立即生效，並使用了剩餘依比例計費的折抵金額，且依舊在 8 月 1 日續訂。

如要提供不同的價格 (例如新的免費試用期或挽回折扣)，可以改為向該使用者提供不同的 SKU：

• 運用取代模式 WITHOUT_PRORATION，透過不同 SKU 執行升級或降級。
• 新訂閱項目會取代舊訂閱項目，並於相同的到期日續訂。在原有的到期日向使用者收取新 SKU 的費用，包括任何新用戶優惠價。如果舊訂閱項目是使用經過模糊處理的帳戶 ID 建立的，應將相同的 ID 傳遞至 BillingFlowParams 以執行升級和降級。
• 例如，Achilles 訂閱了 Example Music 應用程式，訂閱將於 8 月 1 日到期。7 月 10 日，他又使用新用戶優惠重新訂閱了按年訂閱的方案。新訂閱方案會立即生效，並且將於 8 月 1 日依新用戶優惠向他收取費用。
• 如果您決定在挽回 SKU 中納入免費試用期或新用戶優惠，請在 Google Play 管理中心取消勾選「允許每個應用程式免費試用一次」方塊，確保使用者符合資格。這個選項會限制每個應用程式只能向使用者提供一次免費試用。

收到購買憑證後，如同處理新訂閱項目一樣處理購買交易。另外，Google Play Developer API 會在訂閱資源中傳回 linkedPurchaseToken。請務必讓 linkedPurchaseToken 中提供的憑證失效，確保舊的憑證無法用來存取服務。

訂閱到期前 - Play 商店中

如果取消的訂閱項目尚未到期，使用者只要在 Google Play 訂閱中心按一下「重新訂閱」(先前為「還原」)，即可還原該訂閱項目。這樣就能保有相同的訂閱項目和購買憑證。

若要進一步瞭解如何還原訂閱項目，請參閱還原。

訂閱到期後 - 應用程式內

您可以採取與新訂閱者相同的應用程式內產品購買流程，讓已過期的訂閱者在應用程式內重新訂閱。請注意以下事項：

• 如要向使用者提供折扣，建議您為訂閱項目提供設有特價優惠的產品 ID (也稱為挽回 SKU)。您可以在應用程式中提供優惠，或在應用程式外向使用者通知優惠內容，例如傳送電子郵件。
• 若要訂閱一個挽回訂閱，請使用 Google Play 帳款服務資料庫在 Android 應用程式中啟動購買流程。這個流程與新訂閱項目相同，但您可以決定使用者可用的 SKU。
• 如果您決定在用於挽回的 SKU 中納入免費試用期或新用戶優惠，請在 Google Play 管理中心取消勾選「允許每個應用程式免費試用一次」方塊，以確保使用者符合資格。這個選項會限制使用者每個應用程式只能取得一次免費試用。
• 如果使用者重新訂閱相同的 SKU，就不符合免費試用或新用戶優惠的資格。請確認 UI 能反映出這些資訊。

收到購買憑證後，如同處理新訂閱項目一樣處理購買交易。您將不會在訂閱資源中收到 linkedPurchaseToken。

訂閱到期後 - Play 商店中

如果是啟用的狀態，使用者只要在 Google Play 訂閱中心按一下「重新訂閱」，即可在到期後重新訂閱相同的 SKU，最長可訂閱一年。系統會產生新的訂閱項目和購買憑證。

重新訂閱視為應用程式外購行為，因此請務必遵循「處理應用程式外的購物交易」一節的最佳做法。

宣傳您的訂閱項目

您可以建立促銷代碼，為選取的使用者延長現有訂閱項目的免費試用期。如要瞭解詳情，請參閱促銷代碼。

對於免費試用期，Google Play 會在開始免費試用之前，驗證使用者擁有有效的付款方式。部分使用者可能會在其付款方式以「暫緩付款」或「扣款」的形式看到這項驗證。這筆暫緩付款或扣款只是暫時性的，稍後會退還或退款。

試用期結束後，系統會向使用者的付款方式收取全額訂閱費用。

如果使用者在免費試用期內取消訂閱，訂閱項目在試用期結束前仍然有效，而且在免費試用期結束時也不需付費。

取消、退款或撤銷

您可以使用 Google Play Developer API 取消、撤銷訂閱項目，或為訂閱項目辦理退款。Google Play 管理中心也提供這項功能。

• 取消：使用者可以在 Google Play 取消訂閱項目。您也可以讓使用者選擇在應用程式中或網站上取消訂閱。應用程式應依據「取消」一節所述處理這些取消操作。
• 退款：退款後，使用者可以繼續使用該訂閱項目。例如，如果有技術錯誤導致使用者無法存取您的產品，但錯誤已得到解決，則可以使用退款功能。請注意，如果退款金額超過最近支付的款項，或是您要進行部分退款，則必須使用 Google Play 管理中心。
• 撤銷：當您撤銷訂閱項目後，使用者會立即失去該訂閱項目的存取權。例如，如果有技術錯誤導致使用者無法存取您的產品，而且使用者不想繼續使用該產品，則可以使用此功能。應用程式應依據「撤銷」一節所述處理這些取消操作。

下表說明取消、退款與撤銷之間的差異。

延後向訂閱者收費

您可以使用 Google Play Developer API 中的 Purchases.subscriptions:defer，將自動續訂者的下一個收費日期往後延。在延後期間，使用者可完整存取訂閱的內容，但無須支付費用。系統將根據延後的收費日期更新續訂日期。

對於預付方案，您可以使用延後收費的 API，將到期時間延後。

您可以藉由延後收費來達成下列目的：

• 以特價優惠的形式向使用者提供免費存取權，例如購買電影可免費享有一週的觀影體驗。
• 提供使用者免費存取以表達善意。

每個 API 呼叫可以將帳單最短延後一天，最長延後一年。若要將收費時間延得更長，您可以在新的收費日期前再次呼叫 API。

舉例來說，Darcy 按月訂閱 Fishing Quarterly 應用程式的線上內容，通常會在每月第一天支付 1.25 英鎊。3 月時她參與了應用程式發布者的線上問卷調查。發布者獎勵她免費六週的使用權，將下次付款日期延後至 5 月 15 日 (也就是原定帳單日期 4 月 1 日後六個星期)。4 月或 5 月初，Darcy 無須支付費用且仍可存取相關內容。5 月 15 日，她支付了該月 1.25 英鎊的正常訂閱費用。下次續訂日期變為 6 月 15 日。

延後時，您可以考慮透過電子郵件或在應用程式內，通知使用者帳單日期已變更。

處理付款遭拒問題

如果訂閱項目續訂時發生付款問題，在取消訂閱項目之前，Google 會定期嘗試續訂一段時間。這段用來解決問題的緩衝期是寬限期加上後續的帳戶保留期。在這段時間內，Google 會傳送電子郵件和通知，請使用者更新付款方式。

付款遭拒時，訂閱項目會進入寬限期 (如果有啟用)。在寬限期內，您應確保使用者仍可存取訂閱授權。

寬限期結束後，訂閱項目進入帳戶保留期。在帳戶保留期間，您應確保使用者無法存取訂閱授權。

您可以在 Google Play 管理中心指定每個自動續約型基本方案的寬限期和帳戶保留期長度。若指定的寬限期或帳戶保留期長度短於預設值，那麼在因扣款遭拒而未能成功續訂者中，恢復訂閱的人數可能減少。

如要在付款遭拒時盡量爭取恢復訂閱，可以通知使用者付款問題並請求對方加以修正。

您可按照「寬限期」和「帳戶保留」章節所述的方式自行執行這項操作，也可以實作應用程式內通訊 API，讓 Google 在應用程式中向使用者顯示訊息。

應用程式內通訊

如果您透過 InAppMessageCategoryId.TRANSACTIONAL 啟用應用程式內通訊功能，Google Play 會在寬限期和帳戶保留期內每天向使用者顯示一次訊息，讓使用者不必離開應用程式就能修正付款問題。

我們建議您在使用者每次開啟應用程式時呼叫此 API，以判斷是否應顯示訊息。

如果使用者成功復原訂閱項目，您會收到 SUBSCRIPTION_STATUS_UPDATED 的回應代碼和購買憑證。接下來，請使用這個購買憑證呼叫 Google Play Developer API，並在應用程式中重新整理訂閱狀態。

整合應用程式內通訊功能

若要向使用者顯示應用程式內通訊訊息，請使用 BillingClient.showInAppMessages()。

以下是觸發應用程式內訊息流程的範例：

val inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build()

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        object : InAppMessageResponseListener() {
            override fun onInAppMessageResponse(inAppMessageResult: InAppMessageResult) {
                if (inAppMessageResult.responseCode == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        })

InAppMessageParams inAppMessageParams = InAppMessageParams.newBuilder()
        .addInAppMessageCategoryToShow(InAppMessageCategoryId.TRANSACTIONAL)
        .build();

billingClient.showInAppMessages(activity,
        inAppMessageParams,
        new InAppMessageResponseListener() {
            @Override
            public void onInAppMessageResponse(InAppMessageResult inAppMessageResult) {
                if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.NO_ACTION_NEEDED) {
                    // The flow has finished and there is no action needed from developers.
                } else if (inAppMessageResult.responseCode
                        == InAppMessageResponseCode.SUBSCRIPTION_STATUS_UPDATED) {
                    // The subscription status changed. For example, a subscription
                    // has been recovered from a suspend state. Developers should
                    // expect the purchase token to be returned with this response
                    // code and use the purchase token with the Google Play
                    // Developer API.
                }
            }
        });

處理訂閱項目待處理交易

待處理交易可能會發生在初始購買、儲值、升級或降級時。訂閱購買交易會從 SUBSCRIPTION_STATE_PENDING 狀態開始，然後轉換為 SUBSCRIPTION_STATE_ACTIVE。如果交易已過期或遭到使用者取消，則會轉移至 SUBSCRIPTION_STATE_PENDING_PURCHASE_EXPIRED。您必須且應僅在交易完成後更新使用者的授權。

對於初始購買交易 (含待處理交易) 的訂閱狀態變更，處理方式相當簡單。當使用者啟動待處理交易時，應用程式會收到狀態為 PENDING 的 Purchase。交易完成後，應用程式會再次收到 Purchase，且狀態會更新為 PURCHASED。系統會將 SUBSCRIPTION_PURCHASED 類型的 SubscriptionNotification 訊息傳送至您的 RTDN 用戶端。按照正常流程驗證購買交易、授予使用者內容存取權，並確認購買交易。如果交易到期或遭到取消，系統會將 SUBSCRIPTION_PENDING_PURCHASE_CANCELED 類型的 SubscriptionNotification 訊息傳送至您的 RTDN 用戶端。在這種情況下，使用者應該從未取得內容存取權。

使用待處理交易進行儲值、升級或降級時，會涉及舊訂閱和新訂閱的狀態變更。當使用者啟動待處理的儲值、升級或降級交易時，應用程式會收到舊訂閱項目的 Purchase，其中包含 PendingPurchaseUpdate 物件。目前，使用者仍擁有舊訂閱項目，尚未獲得新訂閱項目。對 PendingPurchaseUpdate 物件呼叫 getProducts() 和 getPurchaseToken() 會傳回新訂閱項目的產品 ID 和購買憑證。交易完成後，應用程式會收到 Purchase，其中包含新訂閱項目的頂層購買權杖，並將狀態設為 PURCHASED。系統會將 SUBSCRIPTION_PURCHASED 類型的 SubscriptionNotification 訊息傳送至您的 RTDN 用戶端。只有在這個時候，您才應將舊購買憑證替換為新購買憑證，並更新使用者對內容的存取權。如果交易到期或遭到取消，系統會將 SUBSCRIPTION_PENDING_PURCHASE_CANCELED 類型的 SubscriptionNotification 訊息傳送至您的 RTDN 用戶端。在這種情況下，使用者仍應可存取舊訂閱項目的內容。