3.10【银行用户信息变更申请】接口


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

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

接口代码(transCode):1045

接口说明:

中信托管:仅支持修改【个人基本信息】、【企业基本信息】;

  • 个人会员信息修改:用户名称、用户证件类型、用户证件号码等个人基本信息、用户手机号/电话;
  • 企业会员信息修改:企业名称、企业证件类型、企业法人姓名、企业法人身份证号等企业基本信息;

说明:个人基本信息修改、企业基本信息修改,中信银行自动做系统认证,无需人工审核。

华通托管:可修改【个人详细信息】、【企业基本信息】+【企业详细信息】

个人信息修改:

  • 可修改手机号码、职业、国籍地区编码、住所地、证件有效期、个人证件正反面等个人详情信息;
  • 若修改有效期和个人证件正反面必须一起修改,不能单独修改。
  • 修改证件有效期时,生效日期、失效日期,图片必须一起改
  • 若修改手机号需进行运营商三要素(姓名/身份证/手机号)鉴权,通过才能修改成功;

  说明:个人详细信息修改,华通银行自动做系统认证,无需人工审核。

个体工商户(绑定对私卡)信息修改:

  • 可修改手机号码、职业、住所地、证件有效期、个人证件正反面、营业执照号码、营业执照图片等信息。
  • 若修改有效期和个人证件正反面必须一起修改,不能单独修改。
  • 若修改手机号需进行运营商三要素(姓名/身份证/手机号)鉴权,通过才能修改成功。
  • 修改证件有效期时,生效日期、失效日期,图片必须一起改
  • 信息修改,地区码字段,必填

企业(绑定对公户)信息修改:

  • 可修改企业名称、法人姓名、法人证件类型、法人证件号码、法人证件有效期、营业执照有效期、手机号码、企业注册地址、国籍、地区编码、行业等基本信息和详细信息。
  • 上述任一信息修改、必须上传营业执照(必填);法人信息修改必须传法人身份证正反面;
  • 企业名称修改,原绑定卡在人工审核通过后会解除绑定,需要客户重新绑定修改后名称一致的卡。
  • 有涉及到修改证件有效期时,法人证件类型、生效日期、失效日期三个必须一起上送(股东证件类型、生效日期、失效日期三个必须一起上送;受益人证件类型、生效日期、失效日期三个必须一起上送);

说明:企业基本信息和详细信息修改,需要进入人工审核流程,待审核记录中需展示客户申请修改的字段名称,审核结果有【企业会员簿记开户审核结果通知】异步通知

业务请求参数

字段

字段类型

字段长度

必填

字段名称

说明

reqTraceNum

String

 

是

商户请求流水号

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

signNum

String

 

是

商户会员编号

 

subAcctNo

String

 

是

银行子账号

 

personBaseInfo

JSONObject

 

否

个人基本信息

详情

中信银行,可上送修改

华通银行,不上送修改

personalDetail

JSONObject

 

否

个人详细信息

华通银行,可上送修改

enterpriseBaseInfo

JSONObject

 

否

企业基本信息

详细

中信银行,可上送修改

华通银行,可上送修改

enterpriseDetail

JSONObject

 

否

企业详情信息

华通银行,可上送修改

notifyUrl

String

 

否

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

华通银行,必须上送

bankAcctExtInfo

JSONObject

 

否

银行其他信息

说明:中信银行上送修改

 

【个人基本信息】对象

字段

字段类型

必填

字段名称

name

String

否

姓名

cerType

String

否

证件类型

cerNum

String

否

身份证号码 ,加密

【个人详细信息】对象

字段

字段类型

必填

字段名称

说明

phone

String

否

手机号码

华通银行:若修改手机号需进行运营商三要素(姓名/身份证/手机号)鉴权,通过才能修改成功

address

String

否

住所/工作地址

 

areaCode

String

否

地区码(省市区/县)

华通银行:必填

country

String

否

国籍

 

profession

String

否

职业

 

certBeginDate

String

否

证件有效开始日期

华通银行:修改证件有效期时,生效日期、失效日期,图片必须一起改

格式:yyyy-MM-dd

certEndDate

String

否

证件有效截止日期

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

certFrontToken

String

否

个人身份证(肖像面)token

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

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

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

certBackToken

String

否

个人身份证(国徽面)token

 

【企业基本信息】对象

字段

字段类型

必填

字段名称

说明

enterpriseName

String

否

企业名称

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

addressCode

String

否

地区码(企业注册地所在省市区)

见数据字段

说明:华通银行,个体工商户性质,必填

enterpriseAdress

String

否

企业注册地地址

 

unifiedSocialCredit

String

否

统一社会信用

 

busLicenseValidate

String

否

营业证件有效期

 

busLicenseLicEffDate

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

否

法人手机号码

华通银行:个体工商户性质,若修改手机号需进行运营商三要素(姓名/身份证/手机号)鉴权,通过才能修改成功

legpCerFrontFileId

String

否

法人身份证(肖像面)token

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

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

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

华通银行(企业性质),“统一信用证token”必填

legpCerBackFileId

String

否

法人身份证(国徽面)token

 

unifiedSocialCreditFileId

String

否

统一信用证token

 

 

【企业详细信息】对象

字段

字段类型

必填

字段名称

说明

enterpriseScale

String

否

企业规模

针对华通银行(企业性质),可上送修改

enterpriseType

String

否

企业类型

针对华通银行(企业性质),可上送修改

economicNature

String

否

企业经济性质

针对华通银行(企业性质),可上送修改

country

String

否

国籍

 

regCapital

String

否

企业注册资本

单位:元

针对华通银行(企业性质),可上送修改

occupation

String

否

行业

 

说明:个体工商户,上送职业枚举值,企业性质,上送“行业”枚举值

businessBeginDate

String

否

公司经营开始时间

格式:yyyy-MM-dd

针对华通银行(企业性质),可上送修改

businessEndDate

String

否

公司经营结束日期

格式:yyyy-MM-dd

针对华通银行(企业性质),可上送修改

contactMobile

String

否

企业联系人手机号

针对华通银行(企业性质),可上送修改

linkAddresscode

String

否

经营地址省市区/企业联系地址所在省市区,地区码

针对华通银行(企业性质),可上送修改

enterpriseAddress

String

否

经营详细地址/企业联系地址

针对华通银行(企业性质),可上送修改

businessScope

String

否

经营范围

针对华通银行(企业性质),不上送

openLicenseCode

String

否

开户许可证核准号或基本存款账户编号

针对华通银行(企业性质),不上送

openLicenseToken

String

否

开户许可证文件

针对华通银行(企业性质),不上送

shareholderInfo

JSONObect

否

控股股东/实际控制人

针对华通银行(企业性质),可上送修改

beneficiaryInfo

JSONObect

否

受益所有人信息

针对华通银行(企业性质),可上送修改

 

银行用户信息变更(其他)信息(bankAcctExtInfo)

字段

字段类型

必填

字段说明

acctRole

String

否

银行用户角色

registerPhone

String

否

个人用户注册手机号

signFlag

String

否

签约标识,
1:是
0:否

agreeNum

String

否

签约协议号

响应请求参数

字段

字段类型

必填

字段名称

说明

respTraceNum

String

否

响应流水号

必填字段校验均通过,返回此字段

signNum

String

否

商户会员编号

业务返回码=00000,返回

respCode

String

是

业务返回码

00000:代表成功

66666、66667:处理中,即当前的请求已受理,需要继续调用关联的确认类接口,或通过发起订单查询、等待异步通知,来获取处理状态。

其他返回码:均代表失败

respMsg

String

否

业务返回说明

 

2026年2月6日 16:33 收藏文档