【FAQ】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）目前还不支持按照等级实现升级和降级。