测试地址: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 |
否 |
业务返回说明 |