一、3201-小文件批量上传
1. 接口功能
批量上传小文件,单个文件大小不超过2M,文件数量不超过5个。图片支持 jpg 、png格式(不支持手动修改图片后缀) 。文件存储ID(FileID)对应需调用3201的其他接口中的上传照片ID(UploadFileID)。
2. 报文结构
请求报文:
报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 | |
TxCode | R | NOT NULL | N1..4 | 交易类型 | |
InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 | |
TxSN | R | NOT NULL | ANS1..32 | 交易流水号 | |
Files | FileName | R | NOT NULL | ANS1..256 | 文件名称 例如: img_best.jpg |
FileContent | R | NOT NULL | ANS1.. | 文件内容 Base64 | |
Remark | O | ANS0..256 | 备注 |
响应报文:
报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 | |
Code | R | NOT NULL | N1..6 | 响应代码 | |
Message | R | NOT NULL | ANS1..256 | 响应消息 | |
TxCode | C | ANS1..4 | 交易类型 | ||
InstitutionID | C | ANS1..8 | 机构号 | ||
TxSN | C | ANS1..32 | 交易流水号 | ||
TraceNo | C | ANS1..32 | 系统跟踪号 | ||
Files | FileName | C | ANS1..256 | 文件名称 | |
FileID | C | ANS1..32 | 文件存储ID |
二、4030-营业执照ocr
1. 接口功能
解析营业执照照片信息。需要将图片先通过3201接口上传到服务器,然后再发送4030验证请求。上传照片ID(UploadFileID)对应3201接口响应的FileID。(接口时序图:ocr接口介绍)
2. 报文结构
请求报文:
报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
---|---|---|---|---|
TxCode | R | NOT NULL | N1..4 | 交易类型 |
InstitutionID | R | NOT NULL | ANS1..8 | 机构编号 |
TxSN | R | NOT NULL | ANS1..32 | 交易流水号 |
UploadFileID | R | NOT NULL | ANS1..32 | 上传照片ID |
Remark | O | ANS0..64 | 备注 |
响应报文:
报文元素 | 出现要求 | 非空约束 | 数据格式 | 说明 |
---|---|---|---|---|
Code | R | NOT NULL | N1..6 | 响应代码 |
Message | R | NOT NULL | ANS1..256 | 响应消息 |
TxCode | C | NOT NULL | ANS1..4 | 交易类型 |
InstitutionID | C | NOT NULL | ANS1..8 | 机构编号 |
TxSN | C | NOT NULL | ANS1..32 | 交易流水号 |
TraceNo | C | NOT NULL | ANS1..32 | 交易跟踪号 |
ResponseCode | C | NOT NULL | N0..4 | 通道响应代码 |
ResponseMessage | C | NOT NULL | ANS0..256 | 通道响应消息 |
LicenseType | C | NOT NULL | ANS0..100 | 执照类型 |
CompanyName | C | NOT NULL | ANS0..256 | 公司名称 |
CompanyType | C | NOT NULL | ANS0..300 | 公司类型 |
Address | C | NOT NULL | ANS0..2000 | 住所 |
RegistrationCode | C | NOT NULL | ANS0..100 | 注册号 |
SerialNumber | C | NOT NULL | ANS0..100 | 证照编号 |
LrName | C | NOT NULL | ANS0..192 | 法人姓名 |
RegisteredCapital | C | NOT NULL | NS0..32 | 注册资本 |
PaidinCapital | C | NOT NULL | NS0..32 | 实收资本 |
Scope | C | NOT NULL | ANS0.. | 经营范围 |
StartTime | C | NOT NULL | YYYYMMDD | 成立日期 |
OperatingPeriod | C | NOT NULL | YYYYMMDD | 营业期限 |
UniformSocialCreditCode | C | NOT NULL | ANS0..32 | 统一社会信用代码 |
三、报文样例
[!TIP] (测试数据不校验数据真实性,默认为验证结果为匹配,若验证其他结果,可查看“总体规范-6.1.2.4 Remark 备注”)
3201-文件上传接口请求地址与ocr接口不同,需注意接口地址,具体可查看ocr交易地址
1.3201报文样例
请求报文(InstitutionID由中金分配):
{
"TxCode":"3201",
"InstitutionID":"XXXXXX",
"TxSN":"202301161632415618763945679",
"Files":[
{
"FileContent":"iVBORw0KGg......5ErkJggg==",
"FileName":"1.png"
}
],
"Remark":""
}
响应报文:
{
"TxCode":"3201",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"TxSN":"202301161632415618763945679",
"Files":[
{
"FileName":"1.png",
"FileID":"2301161636264863917961152"
}
],
"Code":"2000",
"TraceNo":"2301161636262801312017612"
}
2.4030报文样例
请求报文(InstitutionID由中金分配):
{
"TxCode":"4030",
"InstitutionID":"XXXXXX",
"TxSN":"202301170951500793252669539",
"UploadFileID":"2301161636264863917961152",(3201接口返回)
"Remark":""
}
响应报文:
{
"PaidinCapital":"",
"ResponseCode":"1000",
"TxCode":"4030",
"Address":"北京市西城区平原里小区20号楼1-7.1-9.1-10",
"Message":"SUCCESS",
"InstitutionID":"XXXXXX",
"RegistrationCode":"",
"StartTime":"2010年02月04日",
"LrName":"季小杰",
"CompanyType":"有限责任公司法人独资",
"ResponseMessage":"查询成功",
"Code":"2000",
"LicenseType":"营业执照3",
"CompanyName":"中金支付有限公司",
"RegisteredCapital":"10000万元",
"UniformSocialCreditCode":"91110102551443078Q",
"Scope":"互联网支付(支付业务许可证有效期至2021年12月21日);技术开发;技术服务;技术推广;技术咨询。(企业依法自主选择经营项目,开展经营活动;互联网支付以及依法须经批准的项目,经相关部门批准后依批准的内容开展经营活动;不得从事本市产业政策禁止和限制类项目的经营活动。)",
"SerialNumber":"",
"OperatingPeriod":"2010年02月04日至2030年02月03日",
"TxSN":"202301170951500793252669539",
"TraceNo":"2301170955383001112011952"
}
该文档未解决您的疑问?
查看常见问题