错误信息
The operation was canceled by the user.
错误描述
用户取消当前操作。
可能原因
用户取消了当前操作流程。
处理步骤
向用户提示,操作取消。
错误信息
System internal error.
错误描述
系统内部错误。
可能原因
当前DevEco Studio版本低于DevEco Studio 6.0.1 Release,或HarmonyOS SDK版本低于HarmonyOS 6.0.1 Release SDK。
JWT签名无效或已过期。
使用了优惠签名,但nonce字段重复使用。
IAP Kit开关未打开。
处理步骤
请确认DevEco Studio已升级到DevEco Studio 6.0.1 Release及以上版本,且HarmonyOS SDK已升级到HarmonyOS 6.0.1 Release SDK及以上版本。
请参见生成优惠签名购买参数,检查JWT签名的有效性,确认JWT在有效时间内。
如果使用了优惠签名,请确认nonce字段的唯一性,请勿重复使用。请参见OfferInfo。
请参见开启和激活应用内购买服务确认IAP Kit开关已开启,并已激活。
其他情况请进行重试操作或通过在线提单提交问题。
错误信息
The application is not authorized.
错误描述
应用未被授权访问接口。
可能原因
应用程序签名/身份信息配置有误。
应用的支付服务开关未打开。
处理步骤
请参考配置签名信息检查是否使用了自动签名方式,请使用手动签名方式。
需要使用华为应用内支付功能的应用必须开启和激活应用内购买服务。
错误信息
Invalid product information. Failure reason: Product status is not online.
错误描述
当产品状态为不在线时,系统会产生此错误码。
可能原因
创建的商品状态异常(草稿、待提交、驳回)。
处理步骤
请登录AppGallery Connect网站,选择“APP与元服务 > 在应用列表中点击该商品的应用 > 运营 > 商品管理 > 商品列表”,查看对应商品是否存在且正确、商品信息已经提交审核并审核通过。如未审核通过,可使用沙盒账号来进行沙盒测试。
错误信息
Invalid product information. Failure reason: The product type or product id does not match.
错误描述
当产品类型或产品ID不匹配时,系统会产生此错误码。
可能原因
传入的商品ID、商品类型有误,或者商品价格未配置。
处理步骤
请登录AppGallery Connect网站,选择“APP与元服务 > 在应用列表中点击该商品的应用 > 运营 > 商品管理 > 商品列表”,请确认对应商品ID和商品类型是否正确,并确认商品价格已配置。
错误信息
The application is not authorized. Failure reason: The In-App Purchases Service is not activated.
错误描述
当未激活应用内支付服务时,系统会产生此错误码。
可能原因
IAP Kit开关未开启。
处理步骤
请参见开启和激活应用内购买服务确认IAP Kit开关已开启,并已激活。
错误信息
Too frequent API calls.
错误描述
接口访问过频。
可能原因
接口访问间隔过短。
处理步骤
请控制接口调用频度。接口当前访问间隔时间默认为5s,后续IAP Kit可能会根据需要降低或提高速率限制。
错误信息
The app to which the product belongs is not released in a specified location.
错误描述
商品所属的应用未在指定国家/地区上架。
可能原因
商品所属的应用未在指定国家/地区上架。
处理步骤
请登录AppGallery Connect网站,选择“我的应用 > 分发 > 版本信息 > 准备提交”,查看商品配置的国家/地区。
错误信息
The HUAWEI ID is not signed in.
错误描述
未登录华为账号。
可能原因
未登录华为账号。
处理步骤
引导用户登录华为账号。
错误信息
Failed to purchase a product because the user already owns the product.
错误描述
由于已经拥有该商品,购买失败。
可能原因
该商品已经购买。
处理步骤
可通过queryPurchases接口确认用户是否购买了该商品。
若商品为消耗型商品或非续期订阅商品,检查商品是否发货,确认发货成功之后调用finishPurchase接口完成购买,下次可正常购买。
若商品为非消耗型商品或自动续期订阅商品,已经购买则不能再次购买。
错误信息
The purchase cannot be finished because the user has not paid for it.
错误描述
由于未支付该商品,发货失败。
可能原因
用户未购买该商品。
参数传递错误。
处理步骤
可通过queryPurchases接口确认用户是否购买了该商品。
请排查报错接口的传参是否存在问题。
错误信息
The purchase has been finished and cannot be finished again.
错误描述
此次购买已经完成发货,无需重复发货。
可能原因
此次购买已经完成发货,无需重复发货。
处理步骤
可通过queryPurchases接口查询是否有该商品的确认发货记录。
错误信息
The country or region of the signed-in HUAWEI ID does not support IAP.
错误描述
用户账号所在服务地不在IAP Kit支持结算的国家/地区中。
可能原因
用户账号所在服务地不在IAP Kit支持结算的国家/地区中。
处理步骤
用户账号服务地为非中国境内(香港特别行政区、澳门特别行政区、中国台湾除外)地区。建议应用隐藏相关IAP功能入口。
错误信息
The user is not allowed to make purchase.
错误描述
用户交易被拒绝。
可能原因
交易行为触发IAP Kit风控。
处理步骤
建议稍后重试或更换支付方式。
错误信息
The app provision type is not debug.
错误描述
当前应用不是debug签名的应用。
可能原因
当前应用不是debug签名的应用。
处理步骤
可构建debug签名的应用:
手动签名:您需要在AGC中申请调试证书、注册调试设备、申请调试Profile后,再手动配置签名信息。
错误信息
The HUAWEI ID is not test account.
错误描述
登录的华为账号不是配置的测试账号。
可能原因
未在AppGallery Connect中的“用户与访问”中将登录的账号配置为测试账号。
处理步骤
需要在AppGallery Connect中的“用户与访问”中添加测试账号,具体请参见沙盒测试中添加测试账号流程。
错误信息
Invalid promotional offer id.
错误描述
无效的优惠信息。
可能原因
配置商品信息时没有为该商品配置自定义人群促销。
处理步骤
可通过queryProducts接口确认该商品是否配置了优惠活动,具体请参见设置促销价格。
错误信息
Invalid purchase signature.
错误描述
无效的签名信息。
可能原因
签名密钥及签名参数不合法,或签名失败。
处理步骤
可参考生成优惠签名购买参数进行签名过程处理。
错误信息
The purchase has been refunded or in refund.
错误描述
商品已退款或退款中。
可能原因
商品已退款或正在退款中。
处理步骤
引导用户进订单详情中查看退款状态。
错误信息
Refund is not allowed.
错误描述
该笔订单不允许退款。
可能原因
该笔订单不支持退款。目前应用内集成的退款入口系统组件仅针对非游戏场景开放,暂不支持游戏场景。
处理步骤
在游戏场景不展示退款入口。
错误信息
The purchase order is not found for the signed-in HUAWEI ID.
错误描述
在登录的华为账号上找不到该笔订单。
可能原因
用户登录的华为账号与订单账号不一致,或该笔订单不存在。
处理步骤
建议检查手机登录的华为账号与订单所在的应用账号是否一致,或检查传入订单号是否有误。
错误信息
The operation is not supported.
错误描述
不支持该操作。
可能原因
处理步骤
请按照上述可能原因检查订单是否存在问题。