调用此接口,可对待结算资金进行操作。
接口说明
测试请求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 |
对账文件不存在 |