测试地址:http://116.228.64.55:28082/yst-service-api/tm/handle
生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle
接口代码(transCode):1022
功能说明:
1.支持会员状态:(审核失败/有效)的企业会员上传影印件。
(1)针对企业会员状态=有效时,影印件上传成功,则进行影印件OCR识别和会员实名信息比对。
(2)针对会员状态=审核失败,影印件上传成功,【企业会员实名开户】接口完成实名/走2.针对会员状态:审核失败的会员,通过运营平台人工审核通过后,则自动触发影印件OCR识别及会员实名信息比对。
影印件识别比对逻辑:
OCR识别的影印件类型:统一信用证证件、法人身份证(肖像面+国徽面)
OCR识别比对完成,更新比对结果,并通过【会员资料补录结果通知】接口发送异步通知。
对会员支付账户开户资料审核不通过,需要重新上传的场景,则需继续调用【会员资料补录】接口,上传资料。
资料 |
接口判断处理 |
legpCerFront:法人身份证(肖像面) legpCerBack:法人身份证(国徽面) unifiedSocialCredit:统一信用证 |
比对一致或不一致,均更新原【企业信息管理】中的OCR比对结果,保存证照图片。
|
其他影印件材料 4银行结算账户开户证明 5行业许可证 6 ICP备案许可证 8法人非身份证图片 以下枚举类型参与支付账户校验: 9经营门头照 10经营内景照 11客户经理与门头照 12客户经理手持身份证照片 19 注册证书(受益人) 20 存续证明文件(收益人) 21 公司章程(受益人) 22 合伙协议(受益人) 23 备忘录(受益人) 24 股权结构图(受益人) 25 年报(受益人) 26 其他(受益人) 27-业务合作协议(分账入金) 28-其他证明(分账入金) 29-业务合作协议(出金) 30-其他证明(出金) 31-会员业务资质审核材料 |
|
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
signNum |
String |
60 |
是 |
商户会员编号 |
|
reqTraceNum |
String |
50 |
是 |
请求流水号 |
32位数字,不可包含“|”字符,保证应用下单日唯一性 |
notifyUrl |
String |
256 |
是 |
会员资料补录结果异步通知地址 |
|
legpCerFront |
String |
40 |
否 |
法人身份证(肖像面) |
通过【文件上传下载接口】上传文件图片后获取的fileId,有效期30分钟,图片不超过2M 上传身份证影印件时,则肖像面和国徽面必须同时上传 注:身份证无需上送影印件类型 |
legpCerBack |
String |
40 |
否 |
法人身份证(国徽面) |
|
unifiedSocialCredit |
String |
40 |
否 |
统一信用证 |
|
otherPhotocopyType |
String |
40 |
否 |
其他影印件类型 |
4银行结算账户开户证明 5行业许可证 6 ICP备案许可证 8 法人非身份证证件(护照、港澳通行证、台湾通行证、临时身份证、港澳台居民居住证等) 9经营门头照 10经营内景照 11客户经理与门头照 12客户经理手持身份证照片 19 注册证书(受益人) 20 存续证明文件(收益人) 21 公司章程(受益人) 22 合伙协议(受益人) 23 备忘录(受益人) 24 股权结构图(受益人) 25 年报(受益人) 26 其他(受益人) 27-业务合作协议(分账入金) 28-其他证明(分账入金) 29-业务合作协议(出金) 30-其他证明(出金) 31-会员业务资质审核材料 |
photocopyToken |
String |
40 |
否 |
影印件图片文件 |
“其他影印件类型”时,通过本字段上送图片文件内容 通过【文件上传下载接口】上传文件图片后获取的fileId,有效期30分钟,图片不超过2M |
业务响应参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
respTraceNum |
String |
40 |
否 |
响应流水号 |
业务正常处理,则返回 |
signNum |
String |
60 |
否 |
商户会员编号 |
|
respCode |
String |
5 |
是 |
业务返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
200 |
是 |
失败原因 |
上传失败时返回 |
【会员资料补录结果通知】
功能说明:
通知地址取【会员资料补录】接口请求参数中上送的“会员资料补录结果异步通知地址”
营业执照和法人身份证分别进行OCR识别比对,每次结果变动,均发送通知,因此客户会收到多次结果通知,以最新通知为主;
通知条件如下:
OCR识别与企业工商认证信息是否一致 |
OCR识别与企业法人实名信息是否一致 |
是否发送通知 |
空(云商通调用认证渠道发生异常时为空或未上传时) |
空(云商通调用认证渠道发生异常时为空未上传时) |
不发 |
空 |
否 |
发 |
空 |
是 |
发 |
否 |
空 |
发 |
是 |
空 |
发 |
否 |
否 |
发 |
否 |
是 |
发 |
是 |
否 |
发 |
是 |
是 |
发 |
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signNum |
String |
是 |
商户会员编号 |
|
reqTraceNum |
String |
是 |
请求流水号 |
【会员资料补录】接口上送的reqTraceNum字段 |
enterpriseCompareResult |
String |
否 |
OCR识别与企业工商认证信息是否一致: 1-是 2-否 3-识别失败 |
“OCR识别与企业工商认证信息是否一致”与“OCR识别与企业法人实名信息是否一致”字段有一方发生变更即通知。 |
legalPersonCompareResult |
String |
否 |
OCR识别与企业法人实名信息是否一致: 1-是 2-否 3-识别失败 |
|
compareResults |
String |
否 |
比对结果信息 |
存在多种结果信息一起返回,使用“;”进行拼接 如: 识别与企业法人实名信息不一致;OCR识别与企业工商认证信息不一致 |
enterpriseInfo |
JSONObject |
否 |
企业影印件识别信息 |
|
legalPersonCardFaceInfo |
JSONObject |
否 |
法人影印件肖像面识别信息 |
|
legalPersonCardNationalEmblemInfo |
JSONObject |
否 |
法人影印件国徽面识别信息 |
企业影印件识别信息JOSN(enterpriseInfo)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
respCode |
String |
是 |
返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
是 |
失败原因 |
code不为00000,“msg”字段取值为查询成功; code不为00000,“msg”字段会返回具体的错误原因,取OCR识别通道日志返回的msg字段 |
result |
String |
否 |
识别结果 |
取OCR识别通道详情返回报文里的“result”字段 0-查询到数据 1-未查到数据 |
creditCode |
String |
否 |
统一社会信用 |
result为0时有值 |
corpName |
String |
否 |
企业名称 |
result为0时有值 |
forever |
String |
否 |
有效期是否永久 |
true/false, |
validate |
String |
否 |
有效期 |
该字段当forever为false时有效,格式:yyyy/MM/dd, 如:2999/12/31 |
法人影印件肖像面识别信息JSON(legalPersonCardFaceInfo)
字段 |
字段类型 |
必填 |
字段名 |
说明 |
respCode |
String |
是 |
返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
是 |
失败原因 |
code不为00000,“msg”字段取值为查询成功; code不为00000,“msg”字段会返回具体的错误原因,取OCR识别通道日志返回的msg字段 |
result |
String |
否 |
识别结果 |
取OCR识别通道详情返回报文里的“result”字段 0-查询到数据 1-未查到数据 |
name |
String |
否 |
姓名 |
result为0时有值; |
idCard |
String |
否 |
身份证号 |
result为0时有值; 明文 |
gender |
String |
否 |
性别 |
result为0时有值; 女、男 |
nation |
String |
否 |
民族 |
result为0时有值; 汉 |
birthday |
String |
否 |
生日 |
result为0时有值; 格式如:1995/10/08 |
address |
String |
否 |
地址 |
result为0时有值; |
法人影印件国徽面识别信息JSON(legalPersonCardNationalEmblemInfo)
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
respCode |
String |
是 |
返回码 |
00000:代表成功 66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。 其他返回码:均代表失败 |
respMsg |
String |
是 |
失败原因 |
code不为00000,“msg”字段取值为查询成功; code不为00000,“msg”字段会返回具体的错误原因,取OCR识别通道日志返回的msg字段 |
result |
String |
否 |
识别结果 |
取OCR识别通道详情返回报文里的“result”字段 0-查询到数据 1-未查到数据 |
validDate |
String |
否 |
有效期 |
格式:yyyy/MM/dd-yyyy/MM/dd,如果长期则显示中文 result为0时有值 如:2015/07/10-2025/07/10 |
unitName |
String |
否 |
所属公安单位 |
|
isValid |
String |
否 |
是否过期 |
1未过期,0已过期) result为0时有值 |