HarmonyOS鸿蒙Next中通过iap.queryPurchases查询出的自动续期订阅商品状态是怎样的？

HarmonyOS鸿蒙Next中通过iap.queryPurchases查询出的自动续期订阅商品状态是怎样的？ 请问，我通过iap.queryPurchases查询出的自动续期订阅商品状态，是否跟订阅状态一致？

5 回复

查询的结果和文档中的状态是一致的，可以参考queryPurchases接口的返回结果，其中PurchaseData中关于自动订阅的会返回SubscriptionStatus类型的订阅状态，订阅状态中会有说明：https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-data-model#subscriptionstatus

更多关于HarmonyOS鸿蒙Next中通过iap.queryPurchases查询出的自动续期订阅商品状态是怎样的？的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


queryPurchases 查询到的不是一个简单的“订阅状态布尔值”，它返回的是当前查询条件下的购买数据列表。自动续期订阅要看 purchaseData 里的 jwsSubscriptionStatus，解码验签后再读 lastSubscriptionStatus.status 等字段。

如果你传的是 productType: AUTORENEWABLE 且 queryType: CURRENT_ENTITLEMENT，结果一般表示当前生效中的订阅权益列表；这可以用于启动时恢复权益，但仍建议把 purchaseData 上报服务端验签，并用订阅状态查询接口做二次确认。

常见判断口径：status=1 表示订阅处于生效状态；autoRenewStatusCode=1 表示自动续期仍开启。权益发放后还要关注 finishPurchase/确认发货，否则后续续期或切换订阅组可能受影响。

👍，

通过 iap.queryPurchases 查询自动续期订阅，返回的 PurchaseResult 中主要包含以下状态：purchaseState 字段值为 0（已订阅，正常计费）、1（用户取消订阅，不再续期）、2（已退款）；同时 subscriptionStatus 字段可区分 EXPIRED（已过期）等。具体状态以服务端最新为准。

通过 iap.queryPurchases 查询到的自动续期订阅商品，其返回的购买记录中的状态字段与官方文档《订阅状态》中定义的状态含义完全一致。常见状态包括：

  • ACTIVE：订阅有效期内
  • EXPIRED：订阅已过期（未续期或被取消后过期）
  • PAUSED：暂停续期（用户开启暂停功能）
  • GRACE_PERIOD：宽限期（账单问题暂时保留权限）
  • RENEWING：续期中（过期后重新恢复订阅时）

查询结果直接反映当前订阅的最新状态，无需额外转换。

回到顶部