错误¶
Adapay 为简化您的流程 Adapay SDK 会在内部完成对请求状态码的处理,您将直接获得响应数据,如有异常,则异常信息包含在响应数据中,示例如下(仅以支付为例):
Java
// 调用支付创建方法,获取 Charge对象
Charge ch = Charge.create(chargeParams);
// 返回数据处理
if(ch.isError()) {
// TODO 进行错误处理...
// Charge对象中的 failed_code/failed_msg 等参数包含了错误信息
} else {
// TODO 进行正常处理...
}
错误响应数据¶
Adapay 的错误响应中会包括错误码 failure_code
、简单的描述信息 failure_msg
及用来描述错误发生原因的信息。
错误代码中的 failure_msg
只是为每一个错误给调用方提供一个简单的解释,我们推荐结合使用 type
和 failure_code
来区分不同的错误,并显示自定义的文本给终端用户或舍弃不重要的错误码,而不是将 failure_msg
的内容直接显示给终端用户。
错误参数说明¶
参数 |
描述 |
---|---|
failure_code |
错误码,详见 错误返回码表 |
failure_msg |
返回具体的错误描述 |
type |
错误类型,详见 错误类型表 |
status |
状态描述 |
param |
当发生参数错误时返回具体的参数名,便于定位错误原因,如 id |
返回数据示例¶
{
"failure_code":"request_param_error",
"failure_msg":"金额格式非法,格式为 0.00",
"type":"invalid_request_error",
"status":"failed",
"param":"transAmt"
}
错误类型表¶
类型 |
说明 |
---|---|
invalid_request_error |
请求错误,传入了不正确的地址、参数或值 |
api_error |
Adapay 服务器出现的异常错误 |
channel_error |
第三方支付渠道出现的错误导致请求出现错误,通常您需要对这些可能出现的情况进行处理或者联系我们 |
错误返回码表¶
返回码 |
说明 |
---|---|
request_parameter_error |
请求参数错误 |
system_exception |
系统异常 |
config_exception |
配置错误 |
security_exception |
签名错误 |
token_revoke_error |
Token 注销失败 |
token_apply_error |
Token 申请失败 |
token_invalided |
Token 已失效 |
charge_id_not_exists |
对应支付记录不存在 |
request_order_no_repeate |
请求订单号重复 |
channel_error |
通道异常 |
channel_response_code_fail |
支付渠道响应码错误 |
mer_not_register |
商户未入驻 |