测试地址:http://116.228.64.55:28082/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.云商通运营平台人工审核通过/审核不通过,均发送通知;
字段 |
字段类型 |
字段长度 |
必填 |
字段名称 |
说明 |
reqTraceNum |
String |
50 |
是 |
商户请求流水号 |
商户系统内保持唯一,定义长度为50位 |
signNum |
String |
60 |
是 |
商户会员编号 |
|
auditResult |
String |
1 |
是 |
修改结果: |
2:修改成功。 3:修改失败。 |
auditTime |
String |
20 |
是 |
修改时间 |
格式:20240226170408 |
remark |
String |
200 |
否 |
人工审核备注 |
|
auditResultMsg |
String |
200 |
否 |
失败原因 |