HarmonyOS SDK 闭源开放能力 —IAP Kit

1.问题描述

根据https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-data-model-0000001736334358#section260562820380

文档中的描述，purchaseOrderId 是必选现，具体一笔订单中对应的购买订单号 ID。请问 purchaseOrderId 可以唯一标识一笔订单吗？每个订单的 purchaseOrderId 都不同吗？

解决方案

purchaseOrderId 可以唯一标识一笔订单，每笔订单都不相同。一旦生成，不会发生变化。

2.问题描述

应用内支付自动订阅商品如何退款？

解决方案

目前没有提供取消订阅，撤销订阅（退款）这些服务端接口。用户可以打客服热线咨询退款，华为运营会和你们联系是否退款，退款金额会和你们沟通后进行。可以部分退款。也可以发送邮件至 jointoperation@huawei.com，邮件内容包含华为订单号、应用名称/课程名、退款金额、退款原因等信息。仅订阅订单在有效期内方可申请退款。

3.问题描述

对于自动订阅商品，在没有接入服务端通知的情况下，开发者需要自己同步续订的订单。正确操作是否应在适当的时间（首次下单后，记录订阅的结束时间，在该时间到期后），请求订阅状态查询接口，通过只传入 purchaseToken，去获取最新的订单？

解决方案

通过订阅查询接口轮询可能会出现问题，造成结果不准确。(中间产生的续费订单可能会有遗漏) 建议还是接入服务端通知更加准确。

4.问题描述

根据https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-integrate-subscription-0000001709322386

文档中的开发步骤，若未发货，应用服务器需发放相关权益，并记录对应的订单信息，https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-delivering-subscriptions-0000001762225496文档中描述检查 SubGroupStatusPayload.lastSubscriptionStatus.status

是否为 1（生效中），是则发放相关权益。请问确认发货（标记订单为支付成功，给用户发放权益），是当且仅当满足 SubGroupStatusPayload.lastSubscriptionStatus.status 是否为 1（生效中）和 SubGroupStatusPayload.lastSubscriptionStatus.lastPurchaseOrder==2 时，才可以进行吗?

解决方案

业务识别是否已发货此订单 SubGroupStatusPayload.lastSubscriptionStatus.lastPurchaseOrder，相关文档：

https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-query-subscription-status-0000001757088709#section149821246171719。

业务判断字段：lastPurchaseOrder.finishStatus(1 代表已发货，2 代表未发货)，业务查询到 lastPurchaseOrder 后，确认是否已经发货。如果已发货，则确认已经完成确认发货动作；如果未发货，则发货，并在发货完成后完成确认发货动作。建议业务要记录每一笔订单的发货记录。

5.问题描述

在文档https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-data-model-0000001736334358#section260562820380的描述中

而在自动续期订阅商品场景中，purchaseToken 与订阅 ID 一一对应。

问题一：这里说的订阅 id 是 subGroupGenerationId 吗?

问题二：当用户购买月自动订阅商品，1 个月后产生续费，那么收到的订阅续期通知中的 purchaseToken 是一个新的 purchaseToken 吗？

解决方案

问题一：这里说的订阅 id 是 subscriptionId。

问题二：purchaseToken 续期后也不会变动，类似于 subscriptionId，在续期都不会发生变化，只有在切换订阅的时候会产生新的 purchaseToken 和 subscriptionId。

6.问题描述

在 2024-02-22 日产生一笔测试订单，想要看一下订单明细，在管理中心---我的账户---收益菜单中，并未看到这笔订单，请问在哪里能看到我们的订单明细？

解决方案

可以在：管理中心---开发者中心---我的报表---支付报表 查看

7.问题描述

https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/iap-subscription-functions-0000001709162914，在该文档中对于切换订阅的理解：

例如，售卖自动续订商品的一个订阅组下，有高级月会员，高级年会员，超级月会员，超级年会员。

用户初始购买高级月会员，

（1）如果切换为高级年会员或者超级年会员， 那么属于下周期生效的切换订阅。

（2）如果切换为超级月会员，那么属于立即生效的切换订阅。

请问这个理解对吗？目前还不支持按照等级实现升级和降级？

解决方案

（1）是的，下周期生效的切换订阅。

（2）是立即生效的切换订阅。

（3）目前还不支持按照等级实现升级和降级。