测试地址: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法人非身份证图片 27-业务合作协议(分账入金) 28-其他证明(分账入金) 29-业务合作协议(出金) 30-其他证明(出金) 31-会员业务资质审核材料 |
|
业务请求参数
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
signNum |
String |
60 |
是 |
商户会员编号 |
|
reqTraceNum |
String |
60 |
是 |
请求流水号 |
32位数字,不可包含“|”字符,保证应用下单日唯一性 |
notifyUrl |
String |
256 |
是 |
会员资料补录结果异步通知地址 |
|
legpCerFront |
String |
40 |
否 |
法人身份证(肖像面) |
通过【文件上传下载接口】上传文件图片后获取的fileId,有效期30分钟,图片不超过2M 上传身份证影印件时,则肖像面和国徽面必须同时上传 注:身份证无需上送影印件类型 |
legpCerBack |
String |
40 |
否 |
法人身份证(国徽面) |
|
unifiedSocialCredit |
String |
40 |
否 |
统一信用证 |
|
otherPhotocopyType |
String |
40 |
否 |
其他影印件类型 |
4银行结算账户开户证明 5行业许可证 6 ICP备案许可证 8 法人非身份证证件(护照、港澳通行证、台湾通行证、临时身份证、港澳台居民居住证等) 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识别比对,每次结果变动,均发送通知,因此客户会收到多次结果通知,以最新通知为主;
字段 |
字段类型 |
必填 |
字段名称 |
说明 |
signNum |
String |
是 |
商户会员编号 |
|
reqTraceNum |
String |
是 |
请求流水号 |
【会员资料补录】接口上送的reqTraceNum字段 |
enterpriseCompareResult |
String |
否 |
OCR识别与企业工商认证信息是否一致: 1-是 2-否 3-识别失败 |
“OCR识别与企业工商认证信息是否一致”与“OCR识别与企业法人实名信息是否一致”字段有一方发生变更即通知 |
legalPersonCompareResult |
String |
否 |
OCR识别与企业法人实名信息是否一致: 1-是 2-否 3-识别失败 |
|
compareResults |
String |
否 |
比对结果信息 |
存在多种结果信息一起返回,使用“;”进行拼接 如: 识别与企业法人实名信息不一致;OCR识别与企业工商认证信息不一致 |
enterpriseInfo |
String |
否 |
企业影印件识别信息 |
|
legalPersonCardFaceInfo |
String |
否 |
法人影印件肖像面识别信息 |
|
legalPersonCardNationalEmblemInfo |
String |
否 |
法人影印件国徽面识别信息 |