数据同步
接口说明
此接口支持商户端根据企业税号主动查询此企业在荣 e 通平台的各银行认证状态，支持批量查询。
请求地址
| 环境 | 请求地址 |
| 正式环境 | https://api.cargonpay.com/api/apiJoinPay/bankidentifyquery |
请求参数
| 索引 | ID | 名称 | 长度 | 必须 | 说明 |
| 1 | accessKey | 请求唯一标识 | varchar(36) | 是 | |
| 2 | nonce | 随机号 | varchar(36) | 是 | |
| 3 | timestamp | 时间戳 | varchar(20) | 是 | Unix时间戳，保留到毫秒 |
| 4 | sign | 签名 | varchar(32) | 是 | |
| 5 | taxNoList | 企业税号 | array | 是 | 批量最多一次查询 50 条数据 |
响应参数
| 索引 | ID | 名称 | 长度 | 必须 | 说明 |
| 1 | code | 返回状态码 | varchar(10) | 是 | |
| 2 | message | 返回消息 | varchar(200) | 是 | |
| 3 | data | array | 是 | ||
| 4 | taxNo | 企业税号 | varhcar(20) | 是 | |
| 5 | isBankIdentify | 是否有银行认证 | boolean | 是 | |
| 6 | bankIdentifyList | 银行认证列表 | array | 是 | 当 isBankIdentify为 false 时， 此字段为空的 array |
| 7 | bankCode | 银行编码 | varchar(20) | 是 | |
| 8 | bankName | 银行名称 | varchar(50) | 是 | |
| 9 | isContainUsd | 是否包含美金账号 | boolean | 是 | |
| 10 | isContainCny | 是否包含人民币账号 | boolean | 是 |
请求示例
JSON格式
{
"timestamp": "1725797231000",
"nonce": "1725797231016",
"accessKey": "F0D16DD2EFF945C4B73A4B37F99C2696",
"sign": "26EF65621CFA40D2ACFC3B3AE8B80004",
"taxNoList": ["71823723111016","718237113128642"]
}
复制代码
响应示例
JSON格式
{
"code": "000000",
"message": "",
"data": [{
"taxNo": "71823723111016",
"isBankIdentify": true,
"bankIdentifyList": [{
"bankCode": "BOC",
"bankName": "中国银行",
"isContainUsd": true,
"isContainCny": true
}, {
"bankCode": "CBEC",
"bankName": "浦发银行",
"isContainUsd": true,
"isContainCny": false
}, {
"bankCode": "CMB",
"bankName": "招商银行",
"isContainUsd": false,
"isContainCny": true
}, {
"bankCode": "CITIC",
"bankName": "中信银行",
"isContainUsd": false,
"isContainCny": false
}]
}, {
"taxNo": "718237113128642",
"isBankIdentify": false,
"bankIdentifyList": []
}]
}
复制代码
返回状态码
| 索引 | ID | 名称 |
| 1 | 000000 | 提交成功 |
| 2 | 100001 | 参数无效，【参数名】不正确 |
| 3 | 100002 | 请求时间超出有效时间 |
| 4 | 100003 | 商户accessKey不存在，请联系荣e通客服 |
| 5 | 100004 | 商户accessKey已停用 |
| 6 | 100005 | 验证签名失败 |
| 7 | 100006 | 请求重复，请重新发起(nonce重复) |
| 8 | 200015 | 税号参数超出最大限制范围 |
| 9 | 999999 | 系统错误，请联系技术人员 |
- 请求地址
- 请求参数
- 响应参数
- 请求示例
- 响应示例
- 返回码说明
