4.2【会员资料补录】接口


测试地址: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识别及会员实名信息比对。

2. 支持通过会员资料补录接口上传会员交易控制审核资料

  • 27-业务合作协议(分账入金),28-其他证明(分账入金),对应交易控制类型-分账入金;29-业务合作协议(出金),30-其他证明(出金)对应交易控制类型-分账出金记录;31-会员业务资质审核材料对应交易控制类型-提现会员记录材料附件;上传后会在【会员交易控制审核】菜单对应附件类型可查看;
  • 待审核/审核不通过,则上传数据成功,并更新【会员交易资质控制审核】菜单记录的对应资料;审核通过,接口报错:审核通过,不允许上传,待业支撑审核中:待业务支撑审核中,不允许上传;

影印件识别比对逻辑:

OCR识别的影印件类型:统一信用证证件、法人身份证(肖像面+国徽面)

OCR识别比对完成,更新比对结果,并通过【会员资料补录结果通知】接口发送异步通知。

对会员支付账户开户资料审核不通过,需要重新上传的场景,则需继续调用【会员资料补录】接口,上传资料。

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

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 法人非身份证证件(护照、港澳通行证、台湾通行证、临时身份证、港澳台居民居住证等)

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

JSON

企业影印件识别信息

详情

legalPersonCardFaceInfo

JSON

法人影印件肖像面识别信息

详情

legalPersonCardNationalEmblemInfo

JSON

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

详情

影印件OCR核对信息

企业影印件识别信息JSON

字段

字段类型

必填

字段名称

说明

respCode

String

返回码

000000,则表示渠道查询成功,取OCR识别通道日志返回的code字段

respMsg

String

失败原因

code不为000000,“msg”字段取值为查询成功;

code不为000000,“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

字段

字段类型

必填

字段名

说明

respCode

String

返回码

000000,则表示渠道查询成功,取OCR识别通道日志返回的code字段

respMsg

String

失败原因

code不为000000,“msg”字段取值为查询成功;

code不为000000,“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

字段

字段类型

必填

字段名称

说明

respCode

String

返回码

000000,则表示渠道查询成功,取OCR识别通道日志返回的code字段

respMsg

String

失败原因

code不为000000,“msg”字段取值为查询成功;

code不为000000,“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 2025年4月18日 17:05 收藏文档