文档开发者中心
我的
|

HarmonyOS 6

HarmonyOS 7

IAP应用内支付订单异常处理与确认方案

问题一:IAP中长期"未确认发货"的订单是否会被自动退款?当finishStatus=1已发货/2未发货、needFinish=true时必须确认发货才能完成购买,但一笔从未调用finishPurchase的非消耗型订单,平台侧会保留多久,超过某个时限后是自动退款还是永久挂起。 问题二:如果发生自动退款,服务器是否会收到关键事件通知?自动退款是否同样会向配置的通知地址发送REVOKE/REFUND_TRANSACTION通知,若不会发送通知,将无法回收权益。 问题三:服务端"订单确认发货"与客户端finishPurchase是否对应同一个发货确认状态位?若同一笔订单两端都调用,第二次调用会返回什么?能否用服务端确认发货来确保已发放的订单不会长期停留在未确认状态。 极端场景:用户在应用内完成购买、服务端已发放权益,但客户端在调用finishPurchase之前应用被系统杀掉或网络中断,此后该用户卸载应用或更换设备,不再打开本应用。此时在开发者侧这笔订单已交付,在平台侧该订单将一直停留在"未确认发货"状态。 问题四:接入IAP Kit非消耗型商品时,支付调用过程中发生进程终止、系统异常、网络中断或回调丢失,客户端无法确定是否已创建订单,且未获得purchaseOrderId或purchaseToken。此时如何确认订单是否已在平台侧创建,以及如何安全地重新购买。

点赞
收藏
回复
1
分享
举报
浏览10 发布于4天前未知归属地
全部评论
最多点赞
最新发布
最早发布

【背景知识】

  • iap.finishPurchase:应用完成已购商品的发货后,调用此接口确认发货,指明此次购买流程结束。
  • iap.queryPurchases:查询已购买的订单信息,可指定queryType查询特定状态的订单。
  • IAP Kit(应用内支付服务)为开发者提供应用内支付能力,支持消耗型和非消耗型商品的购买与确认发货流程。
  • iap.createPurchase:发起购买,支持消耗型商品、非消耗型商品、自动续期订阅商品和非续期订阅商品。
  • IAPErrorCode:IAP错误码枚举,包含PRODUCT_OWNED(商品已购买)、SYSTEM_ERROR(系统错误)等错误码。

【解决方案】 问题一解决方案: 未确认发货的订单不会触发平台自动退款,订单将停留在已支付未确认发货状态。IAP的退款均为人工流程(用户通过设置>华为账号>付款与账单>购买记录申请退款,或开发者侧通过HarmonyOS开发者中心退款管理台审批),不存在未确认发货超时自动退款的机制。

问题二解决方案: 退款发生时服务器可以收到通知。用户提交退款申请后,IAP会将退款申请推送至在HarmonyOS开发者中心配置的服务器通知接收地址及HarmonyOS开发者中心退款管理台。退款审批、退款完成等节点均有对应的服务端消息通知,收到退款类通知即可触发服务端权益回收。由于退款均由用户申请或商户审批发起,不存在系统单方面自动退款场景,因此不会出现退款不通知导致权益无法回收的情况。

问题三解决方案: 服务端确认发货与客户端iap.finishPurchase操作的是同一个发货确认状态位。文档明确finishPurchase也可以放到应用服务器处理,即服务端接口POST /order/harmony/v1/application/purchase/shipped/confirm与客户端finishPurchase确认的是同一个发货状态(finishStatus)。一个购买订单号只能发货一次,同一笔订单两端都调用时,第二次会返回重复发货错误(具体错误码以实际联调结果为准),按幂等容错处理即可。

极端场景解决方案: 采用服务端确认发货为主、客户端补单为辅的双保险方案:

  1. 服务端收到支付结果通知并完成验签后,发放商品权益,记录订单与发放记录。
  2. 权益发放成功后,服务端立即调用订单确认发货接口(POST /order/harmony/v1/application/purchase/shipped/confirm)确认该笔订单,不依赖客户端存活,彻底避免订单长期停留在未确认状态。
  3. 客户端保留补单逻辑:应用启动或进入支付相关页面时,调用iap.queryPurchases并指定queryType为iap.PurchaseQueryType.UNFINISHED,查询已支付未确认发货的订单,补做发货确认(覆盖服务端确认失败的场景)。
  4. 在HarmonyOS开发者中心"我的项目>应用内支付服务"中配置服务器通知接收地址,对退款类通知一律触发服务端权益回收流程。
  5. 定期通过服务端订单查询接口对账,兜底捕获未收到通知的退款订单。

问题四解决方案: IAP Kit不提供直接"证明未创建订单"的接口,但提供以下间接确认机制:

  • iap.queryPurchases(queryType: UNFINISHED):查询已购买但未确认发货的订单,若返回空说明无掉单。
  • iap.queryPurchases(queryType: CURRENT_ENTITLEMENT):查询当前有效权益,若返回空说明无有效权益。
  • iap.queryPurchases(queryType: ALL):查询所有订单历史,若返回空说明无任何购买记录。
  • 重新调用iap.createPurchase:若返回PRODUCT_OWNED(错误码1001860051)说明订单已存在;若正常拉起收银台说明前次未创建。

queryPurchases未查到商品不足以认定未创建订单,存在以下查不到的合法场景:订单已确认发货(正式环境)、沙盒环境确认发货后该订单不再通过queryPurchases返回、queryType配置不当(默认UNFINISHED,不覆盖已发货订单)。

推荐处理流程(三步查与重试反查):

  1. queryPurchases(queryType: UNFINISHED, productType: NONCONSUMABLE):查掉单,有结果则补发货并调用finishPurchase。
  2. queryPurchases(queryType: CURRENT_ENTITLEMENT, productType: NONCONSUMABLE):查当前权益,有结果则恢复本地权益。
  3. queryPurchases(queryType: ALL, productType: NONCONSUMABLE):查所有历史,无结果则进入步骤4。
  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层——人工客服兜底(自动手段均无法确认时):引导用户通过"设置>账号>付款与账单>帮助和反馈>问题与建议"反馈,开发者侧通过服务端订单查询接口核实。

展开全部
1楼回复于4天前 未知归属地
写回答
新增插入模板功能
一键使用模板,快速填写内容,轻松发帖~
知道了
  • 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
  • 如您发布的内容为转载内容,请注明内容来源。

我要提问题

了解社区公约,与您携手共创和谐专业的开发者社区。