目录

ArkTS API错误码

以下仅介绍本模块特有错误码,通用错误码请参考通用错误码。

错误码ID 错误信息
1001930000 The operation was canceled by the user.
1001930001 Pay failed.
1001930002 The transaction has been processed.
1001930003 Withhold failed.
1001930010 Duplicate request.
1001930011 Network connection error.
1014900000 The operation was canceled by the user.
1014900001 Payment failed.
1014900002 The transaction has been processed.
1014900003 Duplicate request.
1014900004 Network connection error.
1014900005 The payment environment is not ready.
1020100000 The application does not have the required capability.
1020100001 The user did not accept the agreement.
1020100002 The user canceled the operation.
1020100003 The pre-verify ID is invalid.
1020100004 The network is unavailable.
1020100005 System internal error.
1020100006 The camera permission is not granted.
1020100007 The liveness detection failed.
1020100008 The app ID does not match.
1020100009 The user ID does not match.
1022830000 The operation was canceled by the user.
1022830001 Pay failed.
1022830002 The payInfo invalid. Possible causes: 1.Data format is not json string; 2.Mandatory parameters are left unspecified.
1019200001 System internal error.
1019200002 Network connection error.
1019200003 Trade amount is invalid.

1001930000 用户取消操作

错误信息

The operation was canceled by the user.

错误描述

用户取消操作。

可能原因

用户在支付、签约等过程中取消退出。

处理步骤

向用户提示,取消相关操作。

1001930001 支付失败

错误信息

Pay failed.

错误描述

支付失败。

可能原因

  1. 传入参数orderStr格式错误,prepayId错误或对应订单不存在。

  2. authId、公私钥不匹配,签名错误。

处理步骤

  1. 请检查orderStr是否为json格式的字符串,orderStr里面的字段类型、值是否正确。

  2. 请参见准备证书、签名规则章节进行检查。

1001930002 交易已处理

错误信息

The transaction has been processed.

错误描述

交易已处理。

可能原因

  1. 使用同一个orderStr同时拉起支付收银台。

  2. 已拉起收银台但未完成支付,再次重复拉起收银台支付。

处理步骤

  1. 确认是否存在重复拉起收银台支付。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1001930003 签约失败

错误信息

Withhold failed.

错误描述

签约失败。

可能原因

  1. 传入参数contractStr错误。

  2. 预签约号不正确。

处理步骤

  1. 请检查contractStr是否为json格式的字符串,contractStr里面的字段类型、字段值等是否正确。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1001930010 重复请求

错误信息

Duplicate request.

错误描述

重复请求。

可能原因

调用接口频率太频繁。

处理步骤

  1. 建议调用接口后不要立马再次调用,添加延时处理机制控制。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1001930011 网络连接异常

错误信息

Network connection error.

错误描述

网络连接异常。

可能原因

用户无网络信号或网络不稳定。

处理步骤

应用向用户给出提示,请用户检查网络。

1014900000 用户取消操作

错误信息

The operation was canceled by the user.

错误描述

用户取消操作。

可能原因

用户在支付过程中取消退出。

处理步骤

向用户提示,订单取消。

1014900001 支付失败

错误信息

Payment failed.

错误描述

支付失败。

可能原因

传入orderInfo参数格式错误。

处理步骤

  1. 请检查orderInfo参数格式、内容是否正确。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1014900002 交易已处理

错误信息

The transaction has been processed.

错误描述

交易已处理。

可能原因

使用重复的订单号下单。

处理步骤

查询交易订单,查看订单状态,使用新订单号去交易。

1014900003 重复请求

错误信息

Duplicate request.

错误描述

重复请求。

可能原因

短时间发起相同请求。

处理步骤

  1. 请稍后重试。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1014900004 网络连接异常

错误信息

Network connection error.

错误描述

网络连接异常。

可能原因

用户无网络信号或网络不稳定。

处理步骤

应用向用户给出提示,请用户检查网络。

1014900005 支付环境初始化未完成

错误信息

The payment environment is not ready.

错误描述

支付环境初始化未完成。

可能原因

钱包版本不满足或者未安装,最低版本要求为 1.0.8.305。

处理步骤

  1. 安装或升级钱包版本。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1020100000 应用未开通必要服务

错误信息

The application does not have the required capability.

错误描述

应用未开通必要服务。

可能原因

  1. 用户没有在AppGallery Connect开启相关服务。

  2. profile文件配置不正确。

处理步骤

  1. 登录AppGallery Connect,开启服务,具体可参见开启用户身份验证服务权限开关。

  2. 检查profile配置是否正确,参考申请调试证书和调试Profile文件。

1020100001 用户未同意

错误信息

The user did not accept the agreement.

错误描述

用户未同意协议。

可能原因

用户首次使用时未同意Payment Kit的用户协议。

处理步骤

应用根据需要提示和引导用户同意协议。

1020100002 用户取消操作

错误信息

The user canceled the operation.

错误描述

用户取消操作。

可能原因

用户在验证、授权等过程中取消退出。

处理步骤

向用户提示,取消相关操作。

1020100003 预验证ID无效

错误信息

The pre-verify ID is invalid.

错误描述

预验证ID无效。

可能原因

传入preVerifyId参数错误,失效等。

处理步骤

  1. 请检查preVerifyId是否正确。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1020100004 网络不可用

错误信息

The network is unavailable.

错误描述

网络不可用。

可能原因

用户无网络信号或网络不稳定。

处理步骤

应用向用户给出提示,请用户检查网络。

1020100005 系统错误

错误信息

System internal error.

错误描述

系统错误。

可能原因

无需开发者感知的内部错误。

处理步骤

  1. 应用向用户友好提示,引导用户稍后重试,等系统自行修复。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1020100006 相机权限未开启

错误信息

The camera permission is not granted.

错误描述

相机权限未开启。

可能原因

应用无开启相机权限。

处理步骤

  1. 申请开启相机权限。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1020100007 活体检测失败

错误信息

The liveness detection failed.

错误描述

活体检测失败。

可能原因

活体检测环节失败,包括检测失败,检测超时以及其他异常导致的失败。

处理步骤

  1. 应用向用户友好提示,或稍后重试。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1020100008 appID不匹配

错误信息

The app ID does not match.

错误描述

appId不匹配。

可能原因

当前应用的appID和预校验时的clientId不匹配。

处理步骤

  1. 检查请求预校验接口传递的clientId是否正确。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1020100009 用户ID不匹配

错误信息

The user ID does not match.

错误描述

用户ID不匹配。

可能原因

当前用户的uid和预验证时传递的openId不匹配。

处理步骤

  1. 检查请求预验证接口传递的openId是否正确。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1022830000 用户取消操作

错误信息

The operation was canceled by the user.

错误描述

用户取消操作。

可能原因

用户在支付等过程中取消退出。

处理步骤

向用户提示,取消相关操作。

1022830001 支付失败

错误信息

Pay failed.

错误描述

支付失败。

可能原因

  1. 调用三方支付接口失败。

  2. 系统处理异常。

处理步骤

  1. 请检查payInfo里面的字段类型、值是否正确。明确三方支付接口调用失败具体原因需咨询对应三方支付支撑定位。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1022830002 支付信息无效

错误信息

The payInfo invalid. Possible causes: 1.Data format is not json string; 2.Mandatory parameters are left unspecified.

错误描述

支付信息无效。

可能原因

  1. 传入参数payInfo格式或内容错误、必选参数未传等。

处理步骤

  1. 请检查payInfo是否为json格式的字符串,payInfo里面的字段类型、值是否正确。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1019200001 系统错误

错误信息

System internal error.

错误描述

系统错误。

可能原因

无需开发者感知的内部错误。

处理步骤

  1. 应用向用户友好提示,引导用户稍后重试,等系统自行修复。

  2. 若您的问题仍无法解决,请通过在线提单提交问题,华为支持人员会及时处理。

1019200002 网络不可用

错误信息

Network connection error.

错误描述

网络不可用。

可能原因

用户无网络信号或网络不稳定。

处理步骤

应用向用户给出提示,请用户检查网络。

1019200003 订单金额无效

错误信息

Trade amount is invalid.

错误描述

订单金额无效。

可能原因

tradeOrderAmount数量异常。

处理步骤

检查tradeOrderAmount入参是否正常。

1019200005 商户证书ID无效

错误信息

AuthId is invalid.

错误描述

商户证书ID无效。

可能原因

authId值无效。

处理步骤

检查authId入参是否正常。

1019200006 签名无效

错误信息

Sign is invalid.

错误描述

签名无效。

可能原因

sign值无效。

处理步骤

检查sign入参是否正常。

1019200007 订单上下文无效

错误信息

OrderContext is invalid.

错误描述

订单上下文无效。

可能原因

orderContext值无效。

处理步骤

检查orderContext入参是否正常。

1019200008 未登录华为账号

错误信息

The HUAWEI ID is not signed in.

错误描述

未登录华为账号。

可能原因

未登录华为账号。

处理步骤

引导用户登录华为账号。

1019200009 用户未同意协议

错误信息

The user did not accept the agreement.

错误描述

用户未同意华为支付的用户协议。

可能原因

用户首次使用设备时,未同意华为支付的用户协议。

处理步骤

应用根据需要提示和引导用户同意华为支付的用户协议。

1019200010 商户号无效

错误信息

Merchant no is invalid.

错误描述

商户号无效。

可能原因

mercNo值无效。

处理步骤

检查mercNo入参是否正常。