REST API错误码

公共错误码说明

Payment Kit开放网关会对开发者的应用/元服务接口的非业务类型调用返回错误码。

返回码	结果描述	错误码	错误描述	解决方案
000000	Success	-	-	不涉及
100000	权限不足	INSUFFICIENT_PERMISSION	商户权限受限。	在商户平台检查并配置该产品权限。
200000	缺少必选参数	MISSING_AUTH_HEADER	缺少鉴权参数。	在请求头中构建并传入对应的鉴权信息。
		MISSING_TRACER_ID	缺少tracerId参数。	检查请求参数，每次请求传入唯一的traceId。
		MISSING_HEADER_SIGN	缺少headSign参数。	检查请求参数，传入headerSign。
		MISSING_CALLER_ID	缺少callerId参数。	检查请求参数，传入callerId，对应于商户号。
		MISSING_BODY_SIGN	缺少bodySign参数。	检查请求参数，传入bodySign。
		MISSING_AUTH_ID	缺少authId参数。	检查请求参数，传入商户对应的authId。
		MISSING_TIME	缺少时间戳参数。	检查请求参数，传入当前时间戳信息。
200001	非法的参数	INVALID_AUTH_HEADER	鉴权信息无效。	检查请求头，传入正确的鉴权信息。
		INVALID_TRACER_ID	tracerId参数无效。	检查请求参数，传入正确的traceId。
		INVALID_AUTH_ID	authId参数无效。	检查请求参数，传入正确的authId。
		INVALID_TIME	时间戳参数无效。	检查请求参数，传入正确的时间戳。
		INVALID_SESSION_KEY	sessionKey参数无效。	检查请求参数，传入正确的sessionKey。
		INVALID_PUB_KEY	商户公钥无效。	检查请求参数，确认已生成并上传公钥。
		INVALID_DUPLICATE_REQUEST	无效的重复请求。	检查请求参数，每次请求需要生成新的traceId。
		INVALID_PARAMETER	参数无效。	检查请求参数，传入正确的参数。
		INVALID_CALLER_ID	callerId参数无效	检查鉴权请求头callerId字段传递是否正确（如类型、特殊字符、长度等）。
200002	签名错误	INVALID_SIGNATURE	无效签名。	检查请求参数，按说明完成签名并传入正确的签名参数。
300000	调用频率受限	CALL_FREQUENCY_LIMITED	API调用次数超限。	降低请求并发量。
400000	业务处理失败	对应的错误码和说明见下方具体接口说明。
500000	服务不可用	UNKNOW_ERROR	服务暂不可用, 请稍后重试	稍后重试

业务错误码

响应的错误码示例，具体请参考业务接口（resultCode非400000的错误码请查看公共错误码说明）

返回码	错误码	错误描述	解决方案
400000	UNKNOW_ERROR	服务暂不可用，请稍后重试。	稍后重试。
400000	INVALID_ARGUMENTS	参数不合法。	检查请求参数。
400000	PAY_ORDER_NOT_EXIST	支付订单号不存在。	检查入参订单号是否正确。
400000	MERC_ORDER_NOT_EXIST	商户订单号不存在。	检查入参订单号是否正确。
400000	INVALID_MERCNO	无效商户号。	检查入参商户号是否正确。
400000	REJECTED_BY_RISK_CONTROL	风控拒绝。	咨询华为支付团队，在线提单。
400000	NO_MATCH_MATCHING_PRODUCT	未匹配到商户产品。	检查商户产品是否配置正确。
400000	CHECK_ORDER_STATUS	订单状态异常。	检查订单状态是否正常。
400000	BANK_CARD_NOT_SUPPORT	银行卡不支持。	更换其他银行卡重试。
400000	CHECK_ACCOUNT_STATUS	支付账号异常。	请检查支付账号状态。
400000	CHECK_MERC_STATUS	商户状态异常。	请检查商户状态是否正常。
400000	MERC_NOT_SUPPORT_REFUND	商户不支持退款。	请检查商户是否具有退款权限。
400000	CHECK_AMOUNT_INVALID	金额校验失败。	检查传入金额是否合法。
400000	CHECK_ACCOUNT_BALANCE	账户余额不足。	查看商户账户余额。
400000	RETRY_TOO_MANY	重试次数超限，请换单重试。	换单重新请求。
400000	NOT_SETTLEMENT_DATE	非结算日，账单未生成。	请修改入参日期重试。
400000	INVALID_APPID	appId不匹配。	检查appId是否正确且已经绑定商户号。
400000	BILL_SWITCH_NOT_TURN_ON	账单开关没有打开。	前往“华为支付商户平台”的“功能设置”中开启相应的账单开关。
400000	INVALID_SUB_MERCNO	权限异常，请求传递的子商户号不是验签商户的子商户。	请检查子商户号是否和验签商户正确关联。
400000	ORDER_CONCURRENT_ERROR	订单并发错误。	解决方案： 1. 一笔普通收单多次退款，时间间隔要在1分钟以上 2. 合单多笔子单退款，时间间隔要在1分钟以上
400000	NOT_SUPPORTED_OPERATION	不支持的操作。	请确认操作是否允许，如无法确认可在线提单。。
400000	RESTRICTED_USER_ACCOUNT	用户账户受限	请确认用户账户状态是否正常。
400000	RESTRICTED_USER_TRANSACTION	用户交易受限	请确认用户状态是否正常。
400000	RESTRICTED_MERCHANT_TRANSACTION	商户交易受限	请检查商户支付账号状态是否正常。
400000	CHECK_CONTRACT_STATUS	签约号无效	1. 请确认是否存在签约关系。 2. 检查签约号输入是否正确。

目录

REST API错误码

公共错误码说明

业务错误码