3.5【会员资料补录】接口


测试地址: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-会员业务资质审核材料

  • 会员是否存在“待激活”状态的支付账户:不存在,则接口响应报错:该会员不存在待激活的支付账户。
  • 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

法人影印件国徽面识别信息

详情


maxy2 2025年1月21日 16:44 收藏文档