接口说明

此接口在会员修改环节使用，暂不支持修改会员类型、角色，迁移会员关系。

报文编号 版本号
请求 XHY1-1008-001-01 1.0.0
应答 XHY1-1008-001-01 1.0.0

说明：

  1. 可修改字段均为非必填，仅传入需要修改的字段即可
  2. 股东受益人信息、经营场景信息中的state字段用于控制数据状态：
    • 0：删除该条记录
    • 1：新增或修改该条记录
  3. 附件上传需要先调用文件上传接口获取fileId和相关dfs信息
  4. 时间格式统一为yyyy-MM-dd，长期有效传9999-12-30

请求参数

字段名 参数名 类型 必填 描述
申请编号 applyNo string(32) Y 当前修改申请编号
会员编号 uid string(32) Y 会员编号
会员基础信息 createBaseInfo object N 见createBaseInfo
股东受益人信息 shareholdersInfos array N 见shareHoldersInfo
会员联系人信息 cdpMerchantLinkInfo object N 见cdpMerchantLinkInfo
会员经营信息 cdpMerchantBusinessInfo object N 见cdpMerchantBusinessInfo
会员应用场景 cdpMerchantContextInfos array N 见cdpMerchantContextInfo
会员银行信息 cdpMerchantBankInfo object N 见cdpMerchantBankInfo
修改结果通知地址 notifyUrl string(512) N 用于接收会员信息修改审核结果

会员基础信息createBaseInfo

字段名 参数名 类型 必填 描述
客户名称 customerName string(32) N 客户名称
营业执照所在地 licenseAddress string(64) N 营业执照所在地
营业开始时间 operationStartTerm string(16) N 营业开始时间，yyyy-MM-dd
营业期限 operationEndTerm string(16) N 营业期限，yyyy-MM-dd （长期传9999-12-30）
联系电话 telephone string(16) N 企业联系电话
法人代表姓名 legalName string(32) N 法人代表姓名
法人代表证件种类 corporationCertificatesType string(32) N 证件种类，暂仅支持居民身份证，见参数说明：证件类型
法人身份证号 idCard string(32) N 法人身份证号
法人联系手机 linkMobile string(16) N 法人联系手机
法人证件开始时间 legalStartDate string(16) N 法人证件开始时间，yyyy-MM-dd
法人证件结束时间 legalEndDate string(16) N 法人证件结束时间，yyyy-MM-dd（长期传9999-12-30）
法人代表归属地 legalAddress string(64) N 法人代表归属地
实际经营地址 actualOperatingAddress string(32) N 实际经营地址
办公地址 workingAddress string(32) N 办公地址
注册地址 registeredAddress string(32) N 注册地址
联系地址 address string(64) N 联系地址
补充材料 fileList array N 补充材料，见attachFileInfo

股东受益人信息shareholdersInfos

字段名 参数名 类型 必填 描述
类型 type string(16) N 类型，01-控股股东，02-受益人
选择法人同股东/受益人，可以不填写，否则必填
股东、受益人名称 name string(32) N 股东受益人名称
选择法人同股东/受益人，可以不填写，否则必填
手机号 beneficiaryMobile string(16) N 手机号
选择法人同股东/受益人，可以不填写，否则必填
证件种类 certificatesType string(16) N 证件种类，见参数说明：证件类型
选择法人同股东/受益人，可以不填写，否则必填
证件号码 certificatesNumber string(32) N 证件号码(加密)
选择法人同股东/受益人，可以不填写，否则必填
证件有效期 certificatesStartDate string(16) N 控股股东证件有效期，yyyy-MM-dd
选择法人同股东/受益人，可以不填写，否则必填
证件过期时间 certificatesExpiryDate string(16) N 证件过期时间，yyyy-MM-dd（长期传9999-12-30）
选择法人同股东/受益人，可以不填写，否则必填
联系地址 address string(64) N 联系地址
选择法人同股东/受益人，可以不填写，否则必填
补充材料 fileList array N 补充材料，见attachFileInfo
状态 state string(16) Y 状态，0：删除，1：新增或修改

会员联系人信息cdpMerchantLinkInfo

字段名 参数名 类型 必填 描述
业务联系人 businessName string(32) N 业务联系人
如果选择法人同业务联系人，可以非必填
证件种类 certificatesType string(16) N 证件种类，见参数说明：证件类型
如果选择法人同业务联系人，可以非必填
证件号码 certificatesNumber string(32) N 证件号码
如果选择法人同业务联系人，可以非必填
证件有效期 certificatesExpiryDate string(16) N 证件有效期，yyyy-MM-dd
如果选择法人同业务联系人，可以非必填
证件过期时间 certificatesStartDate string(16) N 证件有效期过期时间，yyyy-MM-dd，长期传9999-12-30
如果选择法人同业务联系人，可以非必填
业务联系电话 businessPhone string(16) N 业务联系人手机
业务邮箱 businessEmail string(32) N 业务邮箱
补充材料 fileList array N 补充材料，见attachFileInfo

会员经营信息cdpMerchantBusinessInfo

字段名 参数名 类型 必填 描述
客群角色 businessType string(16) N 客群角色，见参数说明：客群角色
经营描述说明 businessDesc string(128) N 描述说明见：经营描述说明
经营大类 businessPrimaryTypeId string(16) N 经营大类，枚举值见参数说明：经营大类
经营细类 businessSecondaryTypeId string(16) N 经营细类，枚举值见参数说明：经营细类
行业细类 industrySecondaryTypeId string(16) N 行业细类，枚举值见参数说明：行业细类

会员应用场景cdpMerchantContextInfos

字段名 参数名 类型 必填 描述
应用类型 contextType string(16) N 应用类型，1：线下，2：APP，3：网页端，4：小程序，5：H5，6：公众号，7：快应用
线下时无需传其余字段
应用名称 contextName string(32) N APP，小程序、公众号、快应用时，填写相应应用名称
链接 contextAdd string(64) N 链接地址，移动APP时为：APP下载链接；网页端：PC网站域名；H5：H5链接
备案号 contextBelongNo string(32) N 备案号，小程序时：小程序备案号；快应用：快应用备案号
补充材料 fileList array N 补充材料，见attachFileInfo
状态 state string(16) Y 状态，0：删除，1：新增或修改

会员银行信息cdpMerchantBankInfo

字段名 参数名 类型 必填 描述
银行卡类型 bankType string(16) N 银行卡类型 1:对私 2:对公
开户名 accountName string(32) N 开户名
开户行名称 bankName string(32) N 开户行名称
银行卡号 bankAccount string(32) N 银行卡号
开户地址->省 bankProvince string(32) N 银行卡类型对公必填 开户地址->省
开户城市 bankCity string(32) N 银行卡类型对公必填 开户城市
开户行地址 bankAddress string(64) N 银行卡类型对公必填 开户行地址
补充材料 fileList array N 补充材料，见attachFileInfo

补充材料attachFileInfo

字段名 参数名 类型 必填 描述
文件类别 fileType string(16) N 文件类别，见参数说明：文件类型
文件uuid fileUuid string(32) N 文件uuid

返回参数

公共报文 - 返回参数

字段名 参数名 类型 必填 描述
errorCode 返回码 string(64) C
errorMsg 返回信息 string(32) C
success 响应状态 Boolean Y true：响应成功 false：业务异常
result 返回参数 json C 见下方会员信息修改返回参数

会员信息修改 - 返回参数 (result)

响应成功时返回修改结果信息

示例请求 JSON：

{
   "uid": "1300033838",
   "createBaseInfo": {
      "customerName": "上海测试有限公司",
      "telephone": "021-12345678",
      "legalName": "张三",
      "linkMobile": "13800138000",
      "workingAddress": "上海市浦东新区张江高科技园区"
   },
   "shareholdersInfos": [
      {
         "type": "01",
         "name": "张三",
         "certificatesType": "0",
         "certificatesNumber": "310101198001011234",
         "certificatesStartDate": "2020-01-01",
         "certificatesExpiryDate": "2030-01-01",
         "beneficiaryMobile": "13800138000",
         "address": "上海市浦东新区",
         "state": "1"
      }
   ],
   "cdpMerchantContextInfos": [
      {
         "contextType": "3",
         "contextName": "官方网站",
         "contextAdd": "http://www.example.com",
         "state": "1"
      }
   ],
   "cdpMerchantBusinessInfo": {
      "industryPrimaryTypeId": "9933",
      "industrySecondaryTypeId": "9933001",
      "businessPrimaryTypeId": "21001",
      "businessSecondaryTypeId": "21001001",
      "businessType": "01",
      "businessDesc": "电商平台服务"
   },
   "cdpMerchantLinkInfo": {
      "businessName": "李四",
      "businessPhone": "021-87654321",
      "businessEmail": "lisi@example.com"
   },
   "cdpMerchantBankInfo": {
      "accountName": "上海测试有限公司",
      "bankName": "中国建设银行",
      "bankAccount": "1234567890123456789",
      "bankProvince": "上海",
      "bankCity": "上海",
      "bankType": "2"
   }
}

示例返回 JSON：

成功示例：

{
   "success": true,
   "result": "修改成功",
   "errorCode": null,
   "errorMsg": null
}

失败示例：

{
   "success": false,
   "result": null,
   "errorCode": "PARAM_ERROR",
   "errorMsg": "会员编号不能为空"
}
作者：卢珊  创建时间：2025-07-24 09:55
最后编辑：admin  更新时间：2026-03-17 19:43