【背景知识】
【解决方案】 问题一解决方案: 未确认发货的订单不会触发平台自动退款,订单将停留在已支付未确认发货状态。IAP的退款均为人工流程(用户通过设置>华为账号>付款与账单>购买记录申请退款,或开发者侧通过HarmonyOS开发者中心退款管理台审批),不存在未确认发货超时自动退款的机制。
问题二解决方案: 退款发生时服务器可以收到通知。用户提交退款申请后,IAP会将退款申请推送至在HarmonyOS开发者中心配置的服务器通知接收地址及HarmonyOS开发者中心退款管理台。退款审批、退款完成等节点均有对应的服务端消息通知,收到退款类通知即可触发服务端权益回收。由于退款均由用户申请或商户审批发起,不存在系统单方面自动退款场景,因此不会出现退款不通知导致权益无法回收的情况。
问题三解决方案: 服务端确认发货与客户端iap.finishPurchase操作的是同一个发货确认状态位。文档明确finishPurchase也可以放到应用服务器处理,即服务端接口POST /order/harmony/v1/application/purchase/shipped/confirm与客户端finishPurchase确认的是同一个发货状态(finishStatus)。一个购买订单号只能发货一次,同一笔订单两端都调用时,第二次会返回重复发货错误(具体错误码以实际联调结果为准),按幂等容错处理即可。
极端场景解决方案: 采用服务端确认发货为主、客户端补单为辅的双保险方案:
- 服务端收到支付结果通知并完成验签后,发放商品权益,记录订单与发放记录。
- 权益发放成功后,服务端立即调用订单确认发货接口(POST /order/harmony/v1/application/purchase/shipped/confirm)确认该笔订单,不依赖客户端存活,彻底避免订单长期停留在未确认状态。
- 客户端保留补单逻辑:应用启动或进入支付相关页面时,调用iap.queryPurchases并指定queryType为iap.PurchaseQueryType.UNFINISHED,查询已支付未确认发货的订单,补做发货确认(覆盖服务端确认失败的场景)。
- 在HarmonyOS开发者中心"我的项目>应用内支付服务"中配置服务器通知接收地址,对退款类通知一律触发服务端权益回收流程。
- 定期通过服务端订单查询接口对账,兜底捕获未收到通知的退款订单。
问题四解决方案: IAP Kit不提供直接"证明未创建订单"的接口,但提供以下间接确认机制:
queryPurchases未查到商品不足以认定未创建订单,存在以下查不到的合法场景:订单已确认发货(正式环境)、沙盒环境确认发货后该订单不再通过queryPurchases返回、queryType配置不当(默认UNFINISHED,不覆盖已发货订单)。
推荐处理流程(三步查与重试反查):
- queryPurchases(queryType: UNFINISHED, productType: NONCONSUMABLE):查掉单,有结果则补发货并调用finishPurchase。
- queryPurchases(queryType: CURRENT_ENTITLEMENT, productType: NONCONSUMABLE):查当前权益,有结果则恢复本地权益。
- queryPurchases(queryType: ALL, productType: NONCONSUMABLE):查所有历史,无结果则进入步骤4。
- 重新调用createPurchase:返回
PRODUCT_OWNED则订单已存在需补发货;正常拉起则前次未创建可安全重新购买。
重试条件与补单流程:
- createPurchase返回
SYSTEM_ERROR:检查掉单后可重新调用。 - createPurchase返回
PRODUCT_OWNED(1001860051):商品已购买,走补单流程。 - finishPurchase重试:若返回"重复确认发货"说明之前已成功。
- 应用启动时:调用queryPurchases(UNFINISHED)检查掉单。
无可靠无订单证明时,推荐分层递进恢复流程: 第1层——自动恢复(应用启动时):冷启动调用queryPurchases(UNFINISHED)检查掉单,有掉单则自动补发货并调用finishPurchase,无掉单则正常进入应用。 第2层——重试反查(用户主动触发购买时):createPurchase返回PRODUCT_OWNED走补单流程;返回SYSTEM_ERROR提示"支付环境异常,请稍后重试"并后台执行掉单检查;正常拉起则前次未创建可安全重新购买。 第3层——保守待确认(自动恢复失败时):UI提示"您的支付状态正在确认中,请稍后查看",不阻止用户使用应用其他功能,后台定期重试queryPurchases。 第4层——人工客服兜底(自动手段均无法确认时):引导用户通过"设置>账号>付款与账单>帮助和反馈>问题与建议"反馈,开发者侧通过服务端订单查询接口核实。