企业云联支付

1.接口说明

1.1.通用参数

（1）请求参数

参数	是否必输	说明
appid	是	合作方唯一凭证，由开放银行分配
sign_type	是	签名算法类型
encrypt_data	是	私有域报文加密数据(加密的业务报文)
sign	是	第三方签名串
timestamp	是	时间戳
biz_data	是	私有域报文明文，json格式(业务报文)
encrypt_type	是	加密算法类型
nonce	是	与时间戳结合防治重放攻击

（2）返回参数

参数	说明
code	商业银行返回码
msg	商业银行返回码描述
biz_encrypt	商业银行私有域报文加密内容
biz_content	私有域报文明文
sign	商业银行返回的签名串
responseid	响应日志号

1.2.通用响应码描述

通用响应码

响应码	描述
"4001"	无效的请求路径/后台无此接口
"4002"	应用无权限访问此接口
"4003"	应用访问此接口的权限异常
"4004"	无效的appid，请开发者检查appid的正确性
"5001"	签名验签失败
"5002"	不支持的加密方法
"5003"	重放请求报错
"5004"	请求报文字段缺失
"5005"	请求报文必输字段为空

2.接口列表

API名称	请求入口
企业云联支付申请	https://openbank.abchina.com/GateWay/openabc/...
云联支付状态查询	https://openbank.abchina.com/GateWay/openabc/...
批量代付录入	https://openbank.abchina.com/GateWay/openabc/...
批量代付交易状态查询	https://openbank.abchina.com/GateWay/openabc/...
单笔转账交易推送	https://openbank.abchina.com/GateWay/openabc/...
单笔转账交易推送状态查询	https://openbank.abchina.com/GateWay/openabc/...
批量转账交易推送	https://openbank.abchina.com/GateWay/openabc/...
批量转账交易推送状态查询	https://openbank.abchina.com/GateWay/openabc/...
代发工资交易推送	https://openbank.abchina.com/GateWay/openabc/...
代发工资交易推送状态查询	https://openbank.abchina.com/GateWay/openabc/...
批量代付交易推送	https://openbank.abchina.com/GateWay/openabc/...
批量代付交易推送状态查询	https://openbank.abchina.com/GateWay/openabc/...

2.1.企业云联支付申请

接口描述：企业云联支付申请接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/onlinepay/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/onlinepay/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
VALUE	是	请求报文私有域报文体

特定返回参数：

参数	说明
VALUE	返回报文私有域报文体

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

2.2.云联支付状态查询

接口描述：云联支付状态查询接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/onlinepaystateqry/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/onlinepaystateqry/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
VALUE	是	请求报文私有域报文体

特定返回参数：

参数	说明
VALUE	返回报文私有域报文体

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

2.3.批量代付录入

接口描述：批量代付录入接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/batchinput/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/batchinput/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
VALUE	是	请求报文私有域报文体

特定返回参数：

参数	说明
VALUE	返回报文私有域报文体

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

2.4.批量代付交易状态查询

接口描述：批量代付交易状态查询接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/batchinputstateqry/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/batchinputstateqry/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
VALUE	是	请求报文私有域报文体

特定返回参数：

参数	说明
VALUE	返回报文私有域报文体

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

2.5.单笔转账交易推送

接口描述：单笔转账交易推送接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/pushsingletransfer/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/pushsingletransfer/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
logNo	是	调用方交易日志号
fAccNo	是	转出方帐号
fAccName	是	转出方账户名称
fAccCur	是	转出方帐户币种
amt	是	交易金额
fAccCur	是	转出方帐户币种
currency	是	交易币种
platform	是	平台编码
tAccNo	是	转入方账号
tAccName	是	转入方户名
postscirpt	是	附言
isABC	是	本行转账标识
tBankExNo	否	转入方大额行号
tBankName	否	转入方开户行网点名称
orderNo	否	订单号
payType	否	订单支付类型
merchant	否	商户名称

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
batNo	支付批次号

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

2.6.单笔转账交易推送状态查询

接口描述：单笔转账交易推送状态查询接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/querysinglestate/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/querysinglestate/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
batNo	否	授权申请批次号
logNo	否	调用方交易日志号
platform	是	平台编码

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
status	交易状态
statDesc	交易状态描述
logNo	调用方交易日志号
fAccNo	付款帐号
fAccName	付款户名
tAccNo	收款帐号
tAccName	收款户名
amt	交易金额
currency	交易币种

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

2.7.批量转账交易推送

接口描述：批量转账交易推送接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/pushbatchtransfer/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/pushbatchtransfer/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
logNo	是	调用方交易日志号
fAccNo	是	转出方帐号
fAccName	是	转出方账户名称
fAccCur	是	转出方帐户币种
totalAmt	是	交易总金额
currency	是	交易币种
platform	是	平台编码
postscirpt	否	批次备注
isABC	是	本行转账标识
taskList	是	批量支付信息列表
taskList>>subLogNo	是	调用方子订单日志号
taskList>>tAccNo	是	转入方账号
taskList>>tAccName	是	转入方户名
taskList>> amt	是	交易金额
taskList>>tBankExNo	否	转入方大额行号
taskList>>tBankName	否	转入方开户行网点名称
taskList>>postscript	否	备注

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
batNo	批量支付申请批次号
logNo	调用方交易日志号
taskList	上送信息校验结果
taskList>>seqNo	顺序号
taskList>>taskId	银行方子订单流水号
taskList>>subLogNo	调用方子订单日志号
taskList>>valid	校验通过标识
taskList>>errdesc	校验错误描述

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

2.8.批量转账交易推送状态查询

接口描述：批量转账交易推送状态查询接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/querybatchstate/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/querybatchstate/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
batNo	否	批量转账申请批次号
logNo	否	调用方批次日志号
platform	是	平台编码
taskIds	否	子订单银行流水号列表
subLogNos	否	调用方子订单日志号列表

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
batNo	批量支付申请批次号
logNo	调用方交易日志号
fAccNo	转出方帐号
fAccName	转出方账户名称
fAccCur	转出方帐户币种
status	批次状态
statDesc	批次状态描述
taskList	批量支付信息列表
taskList>>seqno	序列号
taskList>>taskId	银行方子订单流水号
taskList>>status	状态
taskList>>statDesc	状态描述
taskList>>subLogNo	调用方子订单日志号
taskList>>tAccNo	转入方账号
taskList>>tAccName	转入方户名
taskList>>amt	交易金额
taskList>>tBankExNo	转入方大额行号
taskList>>tBankName	转入方开户行网点名称
taskList>>postscript	备注

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

2.9.代发工资交易推送

接口描述：代发工资交易推送接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/pushpaywage/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/pushpaywage/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
logNo	是	调用方交易日志号
fAccNo	是	转出方帐号
fAccName	是	转出方账户名称
fAccCur	是	转出方帐户币种
totalAmt	是	交易总金额
salaryMonth	是	代发工资月份
currency	是	交易币种
platform	是	平台编码
postscirpt	否	批次备注
isABC	是	本行转账标识
taskList	是	批量支付信息列表
taskList>>subLogNo	是	调用方子订单日志号
taskList>>tAccNo	是	转入方账号
taskList>>tAccName	是	转入方户名
taskList>>amt	是	交易金额
taskList>>tBankExNo	否	转入方大额行号
taskList>>tBankName	否	转入方开户行网点名称
taskList>>postscript	否	备注

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
batNo	批量支付申请批次号
logNo	调用方交易日志号
taskList	上送信息校验结果
taskList>>seqNo	顺序号
taskList>>taskId	银行方子订单流水号
taskList>>subLogNo	调用方子订单日志号
taskList>>valid	校验通过标识
taskList>>errdesc	校验错误描述

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

2.10.代发工资交易推送状态查询

接口描述：代发工资交易推送状态查询接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/querypaywagestate/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/querypaywagestate/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
batNo	否	批量转账申请批次号
logNo	否	调用方批次日志号
platform	是	平台编码
taskIds	否	子订单银行流水号列表
subLogNos	否	调用方子订单日志号列表

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
batNo	批量转账申请批次号
logNo	调用方交易日志号
fAccNo	转出方帐号
fAccName	转出方账户名称
fAccCur	转出方帐户币种
status	批次状态
statDesc	批次状态描述
taskList	批量支付信息列表
seqno	序列号
taskId	银行方子订单流水号
status	状态
statDesc	状态描述
subLogNo	调用方子订单日志号
tAccNo	转入方账号
tAccName	转入方户名
amt	交易金额
tBankExNo	转入方大额行号
tBankName	转入方开户行网点名称
postscript	备注

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

"extension":{
  "rspDate":"20211018",
  "rspTime":"163654",
  "rspMsgExt":""
},
"flowNum":"2",
"trCode":"ZHCOFSPXCLOUD0011",
"data":{
  "logNo":"40.129.37.21",
  "fAccName":"珠海市古春堂凉茶有限公司",
  "fAccCur":"156",
  "statDesc":"交易待确认",
  "taskList":[
    {
      "tBankName":"中国农业银行",
      "tBankExNo":"103456789012",
      "statDesc":"交易待确认",
      "postscript":"40.129.37.21",
      "amt":"2.8",
      "tAccNo":"6228480250335803616",
      "subLogNo":"123456789012345678901234567890121",
      "tAccName":"叶俊军",
      "taskId":"20211018110047266009",
      "status":"CFCLOUD1005"
    },
    {
      "tBankName":"中国农业银行",
      "tBankExNo":"103456789012",
      "postscript":"40.129.37.21",
      "statDesc":"交易待确认",
      "amt":"7.2",
      "tAccNo":"6228480250335803616",
      "subLogNo":"123456789012345678901234567890122",
      "tAccName":"叶俊军",
      "taskId":"20211018110047266010",
      "status":"CFCLOUD1005"
    }
  ],
  "fAccNo":"珠海市古春堂凉茶有限公司",
  "status":"CFCLOUD1005"
},
"appId":"SDC201408_02",
"resCode":"0",
"resMessage":"",
"uniqueId":"20211015A1211aw111121c20",
"trVersion":"1"
}

2.11.批量代付交易推送

接口描述：批量代付交易推送接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/pushbatchtrade/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/pushbatchtrade/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
logNo	是	调用方交易日志号
fAccNo	是	转出方帐号
fAccName	是	转出方账户名称
fAccCur	是	转出方帐户币种
payType	是	已签约代付类型
totalAmt	是	交易总金额
currency	是	交易币种
platform	是	平台编码
postscirpt	否	批次备注
taskList	是	批量支付信息列表
taskList>>subLogNo	是	调用方子订单日志号
taskList>>tAccNo	是	转入方账号
taskList>>tAccName	是	转入方户名
taskList>>amt	是	交易金额
taskList>>postscript	否	备注

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
batNo	批量支付申请批次号
logNo	调用方交易日志号
taskList	上送信息校验结果
taskList>>seqNo	顺序号
taskList>>taskId	银行方子订单流水号
taskList>>subLogNo	调用方子订单日志号
taskList>>valid	校验通过标识
taskList>>errdesc	校验错误描述

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

2.12.批量代付交易推送状态查询

接口描述：批量代付交易推送状态查询接口。

请求入口：https://openbank.abchina.com/GateWay/openabc/api/enterprisepayment/querybatchpaywagestate/v1

沙盒测试请求入口： https://openbank.abchina.com/GateWay/SandBox/openabc/api/enterprisepayment/querybatchpaywagestate/v1

通用请求参数：见1.1节

特定请求参数：

参数	是否必输	说明
channel	是	渠道编码
batNo	否	批量转账申请批次号
logNo	否	调用方批次日志号
platform	是	平台编码
taskIds	否	子订单银行流水号列表
subLogNos	否	调用方子订单日志号列表

特定返回参数：

参数	说明
resCode	响应结果码
resMessage	报文响应消息
errorDescription	异常详情
batNo	批量转账申请批次号
logNo	调用方交易日志号
fAccNo	转出方帐号
fAccName	转出方账户名称
fAccCur	转出方帐户币种
status	批次状态
statDesc	批次状态描述
taskList	批量支付信息列表
taskList>>seqno	序列号
taskList>>taskId	银行方子订单流水号
taskList>>status	状态
taskList>>statDesc	状态描述
taskList>>subLogNo	调用方子订单日志号
taskList>>tAccNo	转入方账号
taskList>>tAccName	转入方户名
taskList>>amt	交易金额
taskList>>tBankExNo	转入方大额行号
taskList>>tBankName	转入方开户行网点名称
taskList>>postscript	备注

特定返回码：

响应码	说明
CFCLOUD0001	授权信息录入异常
CFCLOUD0002	已存在授权信息，无法新增申请
CFCLOUD0003	客户号与帐号不匹配，请检查授权信息

请求的JSON格式：

encrypt_data的加密结构示例：

响应的JSON格式：

biz_encrypt的解密结构示例：

{
  "extension":{
    "rspDate":"20211018",
    "rspTime":"162525",
    "rspMsgExt":""
  },
  "flowNum":"2",
  "trCode":"ZHCOFSPXCLOUD0010",
  "data":{
    "logNo":"AAlocaltest20211013",
    "fAccName":"珠海市古春堂凉茶有限公司",
    "fAccCur":"156",
    "batNo":"2021101310598308009",
    "statDesc":"批量交易部分成功",
    "taskList":[
      {
        "tBankName":"中国农业银行",
        "tBankExNo":"103456789012",
        "statDesc":"交易失败",
        "postscript":"40.129.37.21",
        "amt":"2.8",
        "tAccNo":"6228480250335803616",
        "subLogNo":"123456789012345678901234567890121",
        "tAccName":"叶俊军AAlocaltest20211013",
        "taskId":"20211013110047018047",
        "status":"CFCLOUD1004"
      },
      {
        "tBankName":"中国农业银行",
        "tBankExNo":"103456789012",
        "postscript":"40.129.37.21",
        "statDesc":"交易成功",
        "amt":"7.2",
        "tAccNo":"6228480250335803616",
        "subLogNo":"123456789012345678901234567890122",
        "tAccName":"叶俊军AAlocaltest20211013",
        "taskId":"20211013110047018048",
        "status":"CFCLOUD1001"
      },
      {
        "tBankName":"中国农业银行",
        "tBankExNo":"103456789012",
        "postscript":"40.129.37.21",
        "statDesc":"交易失败",
        "amt":"2.8",
        "tAccNo":"6228480250335803616",
        "subLogNo":"123456789012345678901234567890121",
        "tAccName":"叶俊军AAlocaltest20211013",
        "taskId":"20211013110047018049",
        "status":"CFCLOUD1004"
      }
    ],
    "fAccNo":"珠海市古春堂凉茶有限公司",
    "status":"CFCLOUD1002"
  },
  "appId":"SDC201408_02",
  "resCode":"0",
  "resMessage":"",
  "uniqueId":"20211015A1211aw111121c18",
  "trVersion":"1"
}