调用此接口,可对待结算资金进行操作。

接口说明

测试请求URL:https://test-api.huishouqian.com/api/acquiring

生产请求URL:https://api.huishouqian.com/api/acquiring

请求方式:POST

公共请求参数

序号 域名 变量名 出现要求 备注
1 版本号 version M 默认填写1.0.0
2 方法名称 method M TRANSFER_TO_CARD
3 请求格式 format M JSON/XML
4 商户编号 merchantNo M
5 加密类型 signType M 默认:CFCA
6 加密数据 signContent M 请求报文体加密数据,详见业务报文说明
7 摘要 sign O

业务请求参数

序号 域名 变量名 出现要求 备注
1 商户订单号 transNo M 商户系统内部订单号保证不重复,如:201900101130948003
2 交易金额 orderAmt M 单位:分,如:1
3 摘要 remark M 商品说明,例如:iphone商品
4 收款方卡号 accNo M
5 收款方户名 accName M
6 收款方证件号码 idCard C 对私必填
7 收款方手机号 mobile C 对私必填
8 联行号 linkBankNo C 对公必填
9 后台回调地址 returnUrl O 代付完成后,服务器主动通知商户服务器里指定地址,如:
https://www.merchant.com/xxx
10 请求时间 requestDate M 格式[yyyyMMddHHmmss],如:20190101140908

公共响应参数

序号 域名 变量名 出现要求 备注
1 响应状态 success M 服务端响应状态,如果为true,则可以调用result;如果为false,则调用errorCode来获取出错信息
2 响应错误码 errorCode C
3 响应信息 errorMsg C
4 应答报文体 result C 通过对应的加密类型进行解密;

业务响应参数

序号 域名 变量名 出现要求 备注
1 商户订单号 transNo R 原样返回
2 交易订单号 tradeNo M 交易订单号
3 交易金额 orderAmt R 原样返回
4 交易状态 orderStatus M 详见[交易状态]
5 完成时间 finishedDate C 格式[yyyyMMddHHmmss],如:20190101140908
6 错误码 respCode M 详见[错误码]
7 错误信息 respMsg M

交易状态

枚举值 描述
INIT 初始化
PROCESSING 处理中
SUCCESS 成功
FAIL 失败
CLOSE 关闭

错误码

枚举值 描述
000000 交易成功
000001 受理成功
100000 系统异常
100001 系统繁忙,请稍后再试
100002 银行卡信息有误
100003 商户信息异常
100004 不支持该支付通道的交易
100005 参数错误,校验不通过
100006 暂不支持信用卡交易
100007 目前该银行正在维护中,请更换其他银行卡支付
100008 银行卡信息有误,请联系发卡行
100009 无效卡号
100010 该卡未开通银联无卡业务
100011 该卡不支持此交易
100012 绑定关系不存在
100013 绑卡失败
100014 该卡已绑定
100015 渠道不支持退款
100016 渠道不支持部分退款
100017 系统异常,请联系客服
100018 该卡当日失败次数超限
100019 无可用渠道
100020 渠道系统处理失败
100021 渠道支付通道无路由
100200 订单已支付成功,请勿重复支付
100201 交易处理中,请稍后查询
100202 交易失败,请联系发卡行
100203 交易失败
100204 订单已过期,请使用新的订单号发起交易
100205 订单已存在
100206 订单不存在
100207 交易已取消
100208 订单已失败
100209 交易失败,黑名单用户
100210 交易失败,非白名单用户
100211 交易记录不存在
100212 交易失败,风险受限
100500 余额不足
100501 交易金额超限
100502 交易金额低于限额
100503 交易金额不正确
100504 单卡单日余额不足次数超限
100505 单日交易金额超限
100506 单笔交易金额超限
100507 单月交易金额超限
100508 退款金额大于可退金额
100600 短信验证码错误
100601 短信验证码失效
100602 请确认是否发送短信,当前交易必须通过短信验证
200001 系统繁忙,请稍后再试
200002 非法的交易
200003 订单号已存在,请勿重复提交
200004 订单不存在
200005 原订单金额校验不通过
200006 交易结果未决,请稍后查询
200007 查询成功
200008 查询失败
200009 查询结果集为空
200010 批次号已存在
200011 订单数量超过单批次处理量
200012 请求太过频繁,请稍后再试
200013 订单已撤销,不能重复撤销
200014 已经发起退款,不能撤销
200015 不支持此支付类型
200016 撤销成功
200101 请求参数缺省
200102 请求参数校验不通过
200103 验签失败
200104 无效的加密类型
200105 请求商户号不一致
200106 请求时间戳超过误差10分钟
200107 分账参数校验异常
200108 交易主体从属关系异常
200109 业务订单不存在
200110 业务订单状态异常
200111 支付金额超限
200112 业务订单已失效
200113 该业务订单不支持部分支付
200114 业务订单已关闭
200115 非法交易
200116 存在成功/处理中订单,请勿重复提交
200117 订单已经分账不能发起退款/撤销
200118 订单金额不等于交易金额+营销金额
200119 订单金额+交易金额不能都为0
200120 营销账户信息不能为空
200201 商户状态异常,无法进行交易
200202 商户不存在
200203 商户与子商户关系不对应,无法进行交易
200204 门店信息不存在,无法进行交易
200205 终端商户信息不存在,无法进行交易
200206 请求ip白名单未配置
200207 账户状态异常
200208 未查询到会话信息
200209 门店信息不存在
200210 设备信息不存在
200301 商户未开通此产品或渠道
200302 产品渠道不能为空
200401 请求报文解密失败
200402 响应报文加密失败
300101 该卡为信用卡,卡有效期卡安全码不能为空
300201 预绑卡订单不存在
300202 交易非法,预绑卡已失败
300203 交易非法,该卡已绑定
300301 认证支付信息不存在
300401 交易非法,订单已完成
300402 签约协议号有误
300701 商户限额校验不通过
300702 暂不支持该银行卡交易
500001 原单订单状态不为成功
500002 退款金额大于可退金额
500003 原订单不存在
600001 绑定关系不存在
600002 查询对账文件超时
600003 查询对账文件失败
600004 对账文件不存在