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


测试地址:http://116.228.64.55:28082/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

个人用户注册手机号

响应请求参数

字段

字段类型

必填

字段名称

说明

respTraceNum

String

响应流水号

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

signNum

String

商户会员编号

业务返回码=00000,返回

respCode

String

业务返回码

00000:代表成功

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

其他返回码:均代表失败

respMsg

String

业务返回说明

 

maxy2 2024年12月24日 14:59 收藏文档