2.3【会员资料补录】


测试地址: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比对结果,保存证照图片。

  • 会员是否存在“待激活”状态的支付账户:存在
  1. OCR比对一致:在【企业支付账户开户待审核】中落地待审批数据,更新原【企业信息管理】中的OCR比对结果,保存证照图片。
  2. OCR比对不一致:在【企业支付账户开户待审核】中落地待审批数据,且不更新原【企业信息管理】中的OCR比对结果。图片也不保存。

其他影印件材料

4银行结算账户开户证明

5行业许可证

6 ICP备案许可证

8法人非身份证图片

以下枚举类型参与支付账户校验:

9经营门头照

10经营内景照

11客户经理与门头照

12客户经理手持身份证照片

19 注册证书(受益人)

20 存续证明文件(收益人)

21 公司章程(受益人)

22 合伙协议(受益人)

23 备忘录(受益人)

24 股权结构图(受益人)

25 年报(受益人)

26 其他(受益人)

27-业务合作协议(分账入金)

28-其他证明(分账入金)

29-业务合作协议(出金)

30-其他证明(出金)

31-会员业务资质审核材料

  • 会员是否存在“待激活”状态的支付账户:存在,系统则在【企业支付账户开户待审核】菜单中生成/更新该会员的待审批记录中的资料信息。
  • 会员是否存在“待激活”状态的支付账户:不存在,则接口响应报错:该会员不存在待激活的支付账户。
  • 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时有值


maxy2 2024年12月26日 22:59 收藏文档