企业账号

1. 企业账号核验

接口功能 传入企业对公账号、账户名、开户行、开户行地址编码，接口向企业对公账号打入0.01元并附言验证码（六位随机数字）。企业通过回填验证码完成身份核验
接口地址 /payVerify/checkAccountVerifyCode
请求类型 GET

1.1 请求字段

字段名称 字段描述 类型 必传 示例
account 企业对公账号 String 是 755915703210102
accountName 企业对公账户名 String 是 北京数字认证股份有限公司
accountBank 对公账户开户行 String 是 招商银行（详见获取银行名称）银行列表非实时更新，为保证业务正常运转，建议为用户提供手动输入功能，当列表中没有收款行名称时，可以通过手动输入方式传入参数，只要银行名称正确且人民银行支持的，都能够打款成功
accountAddressCode 开户行地址编码 String 是 BJBJ（详见获取银行地址编码）

· 银行转账业务处理时间在5分钟至24小时不等。转账后，用户可通过企业网银查询交易记录获取附言中的验证码 。

· 执行打款的同时会将验证码通过转账的附言发送至用户。附言内容为“验证码：123456”（六位随机数字）

· 打款完成后，可通过查询打款结果接口查询到账情况；通过校验验证码接口完成验证码的核验。

1.2 示例报文

{

​    "version": "1.0",

​    "signAlgo": "HmacSHA256",

​    "signature": "",

​    "deviceId": "DEV_1234",

​    "appId": "APP_1234",

​    "userTransId":"t123",

​    "account": "755915703210102",

​    "accountName": "bjca",

​    "accountBank": "招商银行",

​    "accountAddressCode":"BJBJ"

}

1.3 响应字段

字段名称 字段描述 类型 必传 示例
data resultCode Integer 是 结果码
resultMessage 结果信息 String 否 核验结果详细信息
transId 交易流水号 String 是 fafd4b7ae2154f879a96c58551
userTransId 用户交易流水号 String 是 154f879a96c58551

1.4示例报文

{

​    "status": 200,

​    "message": "成功",

​    "trace": "",

​    "data": {

​        "resultCode": 200,

​        "resultMessage": "成功",

​        "userTransId": "t123",

​        "transId": "50345f28-9b57-490e-a1b0-643a4766b3c7"

​    }

}

2. 企业打款通知

接口功能 传入企业对公账号、账户名、开户行、开户行地址编码，接口向企业对公账号打入0.01元并附言。可用于企业通知下发等业务
接口地址 /payVerify/checkAccount
请求类型 GET

2.1 请求字段

字段名称 字段描述 类型 必传 示例
account 企业对公账号 String 是 755915703210102
accountName 企业对公账户名 String 是 北京数字认证股份有限公司
accountBank 对公账户开户行 String 是 招商银行（详见获取银行名称）银行列表非实时更新，为保证业务正常运转，建议为用户提供手动输入功能，当列表中没有收款行名称时，可以通过手动输入方式传入参数，只要银行名称正确且人民银行支持的，都能够打款成功
accountAddressCode 开户行地址编码 String 是 BJBJ（详见获取银行地址编码）
postscript 附言 String 是 打款附言

· 银行转账业务处理时间在5分钟至24小时不等。转账后，用户可通过企业网银查询交易记录获取附言中的内容 。

· 打款完成后，可通过查询打款结果接口查询到账情况。

2.2 示例报文

{

​    "version": "1.0",

​    "signAlgo": "HmacSHA256",

​    "signature": "",

​    "deviceId": "DEV_1234",

​    "appId": "APP_1234",

​    "userTransId":"t123",

​    "account": "755915703210102",

​    "accountName": "bjca",

​    "accountBank": "招商银行",

​    "accountAddressCode":"BJBJ",

​    "postscript":""

}

2.3 响应字段

字段名称 字段描述 类型 必传 示例
data resultCode Integer 是 结果码
resultMessage 结果信息 String 否 核验结果详细信息
transId 交易流水号 String 是 fafd4b7ae2154f879a96c58551
userTransId 用户交易流水号 String 是 154f879a96c58551

2.4 示例报文

{

​    "status": 200,

​    "message": "成功",

​    "trace": "",

​    "data": {

​        "resultCode": 200,

​        "resultMessage": "成功",

​        "userTransId": "t123",

​        "transId": "50345f28-9b57-490e-a1b0-643a4766b3c7"

​    }

}

3. 获取银行名称

接口功能 获取银行名称列表 银行列表非实时更新
接口地址 /dictBank/getDictBankName
请求类型 GET

3.1 请求字段

字段名称 字段描述 类型 必传 示例
level 优先级 String 是 银行列表优先级1,2

3.2 示例报文

{

​    "version": "1.0",

​    "signAlgo": "HmacSHA256",

​    "signature": "",

​    "deviceId": "DEV_1234",

​    "appId": "APP_1234",

​    "userTransId":"t123",

​    "level": "2"

}

3.3 响应字段

字段名称 字段描述 类型 必传 示例
data transId String 是 交易流水号
userTransId 用户交易流水号 String 是 154f879a96c58551
dictBankNameList code String 否 银行编码
name 银行名称 String 否 中国工商银行

3.4 示例报文

{

​    "status": 200,

​    "message": "成功",

​    "trace": "",

​    "data": {

​        "transId": "fafd4b7ae2154f879a96c585513713fc",

​        "dictBankNameList": [{

​            "code": "CDB",

​            "name": "国家开发银行"

​        }, {

​            "code": "ICBC",

​            "name": "中国工商银行"

​        }]

​    }

}

4. 获取银行地址编码

接口功能 获取银行地址编码列表
接口地址 /dictBank/getDictBankAddress
请求类型 GET

4.1 请求字段

字段名称 字段描述 类型 必传 示例
province 省份 String 否 北京市 为空则返回所有省市列表

4.2 示例报文

{

​    "version": "1.0",

​    "signAlgo": "HmacSHA256",

​    "signature": "",

​    "deviceId": "DEV_1234",

​    "appId": "APP_1234",

​    "userTransId":"t123",

​    "province": "北京市"

}

4.3 响应字段

字段名称 字段描述 类型 必传 示例
data transId String 是 交易流水号
userTransId 用户交易流水号 String 是 154f879a96c58551
dictBankAddressList code String 是 银行地址编码
county 区县 String 是 黄山市
province 省市 String 是 安徽省

4.4 示例报文

{

​    "status": 200,

​    "message": "成功",

​    "trace": "",

​    "data": {

​        "transId": "fafd4b7ae2154f879a96c585513713fc",

​        "dictBankAddressList": [{

​            "code": "BJBJ",

​            "county": "北京市",

​            "province": "北京市"

​        }, {

​            "code": "AHHS",

​            "county": "黄山市",

​            "province": "安徽省"

​        }]

​    }

}

5. 查询打款结果

接口功能 查询企业对公账号打款到账情况 银行转账业务处理时间在5分钟至24小时不等，建议执行转账操作12小时后再查询打款结果
接口地址 /payVerify/queryPayResult
请求类型 POST

5.1请求字段

字段名称 字段描述 类型 必传 示例
queryTransId 交易流水号 String 是 企业打款通知，企业账号核验返回的transId

5.2 示例报文

{

"queryTransId": "fafd4b7ae2154f879a96c585513713fc"

}

5.3 响应字段

字段名称 字段描述 类型 必传 示例
data resultCode Integer 是 结果码
resultMessage 结果信息 String 否 支付失败时返回具体的失败原因，例：银行账户异常
transId 交易流水号 String 是 fafd4b7ae2154f879a96c58551
userTransId 用户交易流水号 String 是 154f879a96c58551

5.4 示例报文

{

​    "status": 200,

​    "message": "成功",

​    "trace": "",

​    "data": {

​        "resultCode": 200,

​        "resultMessage": "成功",

​        "userTransId": "t123",

​        "transId": "50345f28-9b57-490e-a1b0-643a4766b3c7"

​    }

}

6. 校验验证码

接口功能 验证企业对公账号打款验证码
接口地址 /payVerify/checkVerifyCode
请求类型 GET

6.1 请求字段

字段名称 字段描述 类型 必传 示例
queryTransId 交易流水号 String 是 企业账号核验接口，返回报文中的transId字段
verifyCode 验证码 String 是 交易流水中附言或备注中的验证码

6.2 示例报文

{

​    "version": "1.0",

​    "signAlgo": "HmacSHA256",

​    "signature": "",

​    "deviceId": "DEV_1234",

​    "appId": "APP_1234",

​    "userTransId":"t123",

​    "queryTransId": "fafd4b7ae2154f879a96c585513713fc",

​    "verifyCode": ""

}

6.3 响应字段

字段名称 字段描述 类型 必传 示例
data 结果码 Integer 是 resultCode
resultMessage 结果信息 String 是 核验结果详细信息
transId 交易流水号 String 是 fafd4b7ae2154f879a96c58551
userTransId 用户交易流水号 String 是 154f879a96c58551

6.4 示例报文

{

​    "status": 200,

​    "message": "成功",

​    "trace": "",

​    "data": {

​        "resultCode": 200,

​        "resultMessage": "成功",

​        "userTransId": "t123",

​        "transId": "50345f28-9b57-490e-a1b0-643a4766b3c7"

​    }

}