错误

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 只是为每一个错误给调用方提供一个简单的解释,我们推荐结合使用 typefailure_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

商户未入驻