3.13【企业会员信息修改】


测试地址:https://ibstest.allinpay.com/yst/yst-service-api/tm/handle

生产地址:https://ibsapi.allinpay.com/yst-service-api/tm/handle

接口代码(transCode):1035

功能说明:

1、支持修改企业基本信息,“统一社会信用证”字段不可以修改。

2、支持的企业会员范围要求:支持“会员状态=有效”且【会员账户信息查询】菜单会员未关联“统一客户号”/“收银宝商户号”的会员。

注:已开通“云商通二代”服务的平台客户,即平台会员,不支持通过此接口修改信息。

说明:

  • 上述企业会员支持通过此接口修改企业信息,若企业会员已开通银行子账户,不做银行信息同步修改。
  • 平台客户、绑定收银宝商户的待结算户会员、绑定统一客户号的支付账户会员均不支持此接口修改。

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

 

是

商户请求流水号

商户系统内保持唯一,定义长度为50位

signNum

String

 

是

商户会员编号

 

notifyUrl

String

256

是

企业会员信息修改结果通知地址

如下情况,企业会员信息实名成功/失败均发送通知:

(1)接口自动完成实名

(2)运营平台人工审核后

enterpriseBaseInfo

JSONObject

 

否

企业基本信息

详细

业务响应参数

字段

字段类型

字段长度

必填

字段名称

说明

respTraceNum

String

 

否

响应流水号

业务正常处理,则返回

signNum

String

 

否

商户会员编号

 

respCode

String

 

是

业务返回码

 

respMsg

String

200

是

失败原因

法人非身份证证件类型,响应“法人证件类型非身份证类型,需人工审核!”;

企业基本信息JSON(enterpriseBaseInfo)

字段

字段类型

必填

字段名称

说明

enterpriseName

String

否

企业名称

如有括号,用中文格式()

addressCode

String

否

地区码(注册地)

见数据字段

enterpriseAdress

String

否

企业注册地址

 

busLicenseValidate

String

否

营业证件有效期

 

legalPersonName

String

否

法人姓名

 

legalPersonCerType

String

否

法人证件类型

详细

legalPersonCerNum

String

否

法人证件号码

SM4加密,详细

idValidateStart

String

否

法人证件有效开始日期

格式:9999-12-31

idValidateEnd

String

否

法人证件有效截止日期

若长期有效上送“9999-12-31”

格式:9999-12-31

若长期有效上送“9999-12-31”

legalPersonPhone

String

是

法人手机号码

注意:此手机号在绑定手机时会进行法人运营商三要素验证。

publicAcctName

String

否

对公户名

 

legpCerFrontFileId

String

否

法人身份证(肖像面)

通过【文件上传下载接口】上传文件图片后获取的fileId,有效期30分钟,图片不超过2M

法人身份证证件类型:肖像面和国徽面必须同时上传。

法人非身份证证件类型:仅上传“法人身份证(肖像面)token”即可。

legpCerBackFileId

String

否

法人身份证(国徽面)

unifiedSocialCreditFileId

String

否

统一信用证

【企业会员信息修改结果通知】

功能说明:

1.修改成功、修改失败,均发送通知;

2.法人证件类型非大陆身份证,则需要联系运营走人工处理流程;

3.针对企业信息修改涉及OCR识别对比逻辑,则通知中返回OCR相关识别信息;

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

50

是

商户请求流水号

商户系统内保持唯一,定义长度为50位

signNum

String

60

是

商户会员编号

 

auditResult

String

1

是

修改结果:

2:修改成功。

3:修改失败。

auditTime

String

20

是

修改时间

格式:20240226170408

remark

String

200

否

人工审核备注

 

auditResultMsg

String

200

否

失败原因

 

enterpriseCompareResult

String

 

否

OCR识别与企业工商认证信息是否一致:

1-是

2-否

3-识别失败
 

legalPersonCompareResult

String

 

否

OCR识别与企业法人实名信息是否一致:

1-是

2-否

3-识别失败

 

compareResults

String

 

否

比对结果信息

 

enterpriseInfo

JSONObject

 

否

企业影印件识别信息

同【会员资料补录通知】接口一致

legalPersonCardFaceInfo

JSONObject

 

否

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

legalPersonCardNationalEmblemInfo

JSONObject

 

否

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

 

 

 


2026年2月5日 11:30 收藏文档