会员信息修改接口文档
|
报文编号 |
版本号 |
| 请求 |
XHY1-1008-001-01 |
1.0.0 |
| 应答 |
XHY1-1008-001-01 |
1.0.0 |
请求参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 申请编号 |
applyNo |
string(32) |
Y |
当前修改申请编号 |
| 会员编号 |
uid |
string(32) |
Y |
会员编号 |
| 基础信息 |
createBaseInfo |
object |
N |
基础信息,见createBaseInfo |
| 股东受益人信息 |
shareholdersInfos |
array |
N |
股东受益人信息,见shareholdersInfos |
| 经营场景信息 |
cdpMerchantContextInfos |
array |
N |
经营场景信息,见cdpMerchantContextInfos |
| 经营类型信息 |
cdpMerchantBusinessInfo |
object |
N |
经营类型信息,见cdpMerchantBusinessInfo |
| 联系人信息 |
cdpMerchantLinkInfo |
object |
N |
联系人信息,见cdpMerchantLinkInfo |
| 银行信息 |
cdpMerchantBankInfo |
object |
N |
银行信息,见cdpMerchantBankInfo |
| 补充材料 |
supplyFileList |
array |
N |
补充材料,见attachFileInfo |
createBaseInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 客户名称 |
customerName |
string(32) |
N |
客户名称 |
| 联系电话 |
telephone |
string(16) |
N |
企业联系电话 |
| 营业开始时间 |
operationStartTerm |
string(16) |
N |
营业开始时间,yyyy-MM-dd |
| 营业期限 |
operationEndTerm |
string(16) |
N |
营业期限,yyyy-MM-dd(长期传9999-12-30) |
| 营业执照所在地 |
licenseAddress |
string(64) |
N |
营业执照所在地 |
| 法人代表 |
legalName |
string(32) |
N |
法人代表 |
| 法人手机 |
linkMobile |
string(16) |
N |
法人联系手机 |
| 法人代表归属地 |
legalAddress |
string(64) |
N |
法人代表归属地 |
| 法人证件开始时间 |
legalStartDate |
string(16) |
N |
法人证件开始时间,yyyy-MM-dd |
| 法人证件结束时间 |
legalEndDate |
string(16) |
N |
法人证件结束时间,yyyy-MM-dd(长期传9999-12-30) |
| 法人身份证号 |
idCard |
string(32) |
N |
法人身份证号 |
| 法人代表证件种类 |
corporationCertificatesType |
string(32) |
N |
法人代表证件种类,见附录:证件类型 |
| 实际经营地址 |
actualOperatingAddress |
string(32) |
N |
实际经营地址 |
| 办公地址 |
workingAddress |
string(32) |
N |
办公地址 |
| 注册地址 |
registeredAddress |
string(32) |
N |
注册地址 |
| 附件列表 |
fileList |
array |
N |
附件列表,见attachFileInfo |
shareholdersInfos
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 类型 |
type |
string(16) |
Y |
类型,01-控股股东,02-受益人 |
| 股东\受益人名称 |
name |
string(32) |
Y |
股东受益人名称 |
| 证件种类 |
certificatesType |
string(16) |
Y |
证件种类,见附录:证件类型 |
| 证件号码 |
certificatesNumber |
string(32) |
Y |
证件号码 |
| 证件有效期 |
certificatesStartDate |
string(16) |
Y |
控股股东证件有效期,yyyy-MM-dd |
| 证件过期时间 |
certificatesExpiryDate |
string(16) |
Y |
证件过期时间,yyyy-MM-dd(长期传9999-12-30) |
| 手机号 |
beneficiaryMobile |
string(16) |
N |
手机号 |
| 联系地址 |
address |
string(64) |
N |
联系地址 |
| 状态 |
state |
string(16) |
Y |
状态,0:删除,1:新增或修改 |
cdpMerchantContextInfos
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 经营类型 |
contextType |
string(16) |
Y |
经营类型,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 |
场景归属编号,小程序时:小程序备案号;快应用:快应用备案号 |
| 状态 |
state |
string(16) |
Y |
状态,0:删除,1:新增或修改 |
cdpMerchantBusinessInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 行业大类 |
industryPrimaryTypeId |
string(16) |
N |
行业大类,枚举值见附录:经营大类 |
| 行业细类 |
industrySecondaryTypeId |
string(16) |
N |
行业细类,枚举值见附录:宝付新细分类 |
| 行业线归属 |
industryBelongTo |
string(16) |
N |
行业线归属 |
| 经营大类 |
businessPrimaryTypeId |
string(16) |
N |
经营大类,枚举值见附录:经营大类 |
| 经营细类 |
businessSecondaryTypeId |
string(16) |
N |
经营细类,枚举值见附录:经营细类 |
| 经营模式 |
businessType |
string(16) |
N |
经营模式,见附录:经营模式 |
| 经营说明 |
businessDesc |
string(128) |
N |
经营描述说明 |
| 备注 |
remark |
string(128) |
N |
备注 |
cdpMerchantLinkInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 业务联系人 |
businessName |
string(32) |
N |
业务联系人 |
| 业务电话 |
businessPhone |
string(16) |
N |
业务电话 |
| 业务邮箱 |
businessEmail |
string(32) |
N |
业务邮箱 |
| 备注 |
remark |
string(64) |
N |
备注 |
| 证件种类 |
certificatesType |
string(16) |
N |
证件种类,见附录:证件类型 |
| 证件号码 |
certificatesNumber |
string(32) |
N |
证件号码 |
| 证件过期时间 |
certificatesExpiryDate |
string(16) |
N |
证件过期时间,yyyy-MM-dd |
| 证件开始时间 |
certificatesStartDate |
string(16) |
N |
证件有效期开始时间,yyyy-MM-dd |
| 附件列表 |
fileList |
array |
N |
附件列表,见attachFileInfo |
cdpMerchantBankInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 开户名 |
accountName |
string(32) |
N |
开户名 |
| 开户行名称 |
bankName |
string(32) |
N |
开户行名称 |
| 开户行payId |
payId |
string(32) |
N |
开户行名称-payId |
| 银行卡号 |
bankAccount |
string(32) |
N |
银行卡号 |
| 开户城市 |
bankCity |
string(32) |
N |
开户城市 |
| 开户行地址 |
bankAddress |
string(64) |
N |
开户行地址 |
| 备注 |
remark |
string(64) |
N |
备注 |
| 开户地址->省 |
bankProvince |
string(32) |
N |
开户地址->省 |
| 卡类型 |
cardType |
string(16) |
N |
卡类型,1:借记卡,2:信用卡,0:未知 |
| 银行卡类型 |
bankType |
string(16) |
N |
银行卡类型,1:个人银行卡,2:企业银行卡 |
| 联行号 |
cnapsCode |
string(32) |
N |
联行号 |
attachFileInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 文件类别 |
fileType |
string(16) |
Y |
文件类别,见附录:客户文件类型 |
| 文件uuid |
fileUuid |
string(32) |
Y |
文件uuid |
返回参数
公共报文 - 返回参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| errorCode |
返回码 |
string(64) |
C |
|
| errorMsg |
返回信息 |
string(32) |
C |
|
| success |
响应状态 |
Boolean |
Y |
true:响应成功 false:业务异常 |
| result |
返回参数 |
json |
C |
见下方会员信息修改返回参数 |
会员信息修改 - 返回参数 (result)
响应成功时返回修改结果信息
说明:
- 所有字段均为非必填,仅传入需要修改的字段即可
- 股东受益人信息、经营场景信息中的state字段用于控制数据状态:
- 附件上传需要先调用文件上传接口获取fileId和相关dfs信息
- 证件类型、经营模式等枚举值参考附录
- 时间格式统一为yyyy-MM-dd,长期有效传9999-12-30
示例请求 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": "会员编号不能为空"
}
附录
宝付新细分类
| 编码 |
名称 |
| 9933001 |
综合电商 |
| 9933002 |
社交电商 |
| 9933003 |
直销电商 |
| 9933004 |
盲盒电商 |
| 9933005 |
返利电商 |
| 9933006 |
海淘平台 |
| 9934001 |
便利店/超市 |
| 9934002 |
自助零售 |
| 9934003 |
商场/商业街/卖场 |
| 9934004 |
奥特莱斯 |
| 9935001 |
生鲜食品 |
| 9935002 |
加工食品 |
| 9935003 |
综合食品 |
| 9935004 |
茶叶 |
| 9935005 |
酒类 |
| 9935006 |
烟草/雪茄 |
| 9935007 |
营养品/保健品 |
| 9936001 |
服饰鞋包 |
| 9936002 |
美妆个护 |
| 9936003 |
眼镜店 |
| 9936004 |
母婴儿童 |
| 9936005 |
鲜花绿植 |
| 9936006 |
宠物 |
| 9936007 |
计生成人 |
| 9937001 |
贵金属/珠宝首饰/钟表 |
| 9937002 |
名牌奢侈品 |
| 9938001 |
3C数码 |
| 9938002 |
家用电器 |
| 9939001 |
书报/音像 |
| 9939002 |
工艺品/乐器 |
| 9939003 |
办公用品/文具 |
| 9939004 |
户外运动器材 |
| 9939005 |
潮玩周边 |
| 9939006 |
文物经营/文物复制品 |
| 9940001 |
医药销售 |
| 9940002 |
医疗器械销售 |
| 9940003 |
保健辅助治疗器材 |
| 9941001 |
车辆零配件/用品精品 |
| 9941002 |
车辆销售 |
| 9941003 |
二手车销售 |
| 9942001 |
五金商店 |
| 9942002 |
建材商店 |
| 9942003 |
家具/家居家纺 |
| 9943001 |
工业化工 |
| 9943002 |
农业产品 |
| 9943003 |
石油及石油产品 |
| 9943004 |
烟花爆竹 |
| 9943005 |
工业设备售卖 |
| 9944001 |
其他专业零售店 |
| 9945001 |
其他专业批发店 |
| 9946001 |
网络会员权益 |
| 9946002 |
社交/论坛/博客 |
| 9946003 |
图书/视频/音乐 |
| 9946004 |
数码图文 |
| 9946005 |
微短剧 |
| 9946006 |
网络直播 |
| 9946007 |
付费电视 |
| 9946008 |
元宇宙\虚拟产品 |
| 9947001 |
手游页游 |
| 9947002 |
棋牌捕鱼 |
| 9947003 |
游戏资讯 |
| 9947004 |
游戏交易平台 |
| 9948001 |
堂食餐饮 |
| 9948002 |
点心熟食 |
| 9948003 |
酒饮消费 |
| 9948004 |
宴会服务 |
| 9949001 |
娱乐场所 |
| 9949002 |
棋牌电玩 |
| 9949003 |
健身运动 |
| 9949004 |
院线演出 |
| 9949005 |
游乐园 |
| 9949006 |
文化场馆 |
| 9949007 |
体育场馆 |
| 9950001 |
酒旅民宿 |
| 9950002 |
景区 |
| 9950003 |
景区服务 |
| 9950004 |
旅行社 |
| 9950005 |
旅游直销 |
| 9950006 |
邮轮列车 |
| 9950007 |
旅游平台(OTA) |
| 9951001 |
综合生活服务平台 |
| 9951002 |
外卖外送 |
| 9951003 |
二手商品交易平台 |
| 9951004 |
团购服务 |
| 9951005 |
众筹平台 |
| 9952001 |
美容美体 |
| 9952002 |
洗浴保健 |
| 9952003 |
家政维修 |
| 9952004 |
装饰装修 |
| 9952005 |
房屋中介服务 |
| 9952006 |
宠物医院及服务 |
| 9952007 |
婚介婚庆/摄影服务 |
| 9952008 |
卡券回收 |
| 9952009 |
3C回收 |
| 9952010 |
黄金奢侈品回收 |
| 9952011 |
生活物资回收 |
| 9953001 |
电商代运营 |
| 9953002 |
广告/会展/图文印刷 |
| 9953003 |
法律服务 |
| 9953004 |
咨询审计财务 |
| 9953005 |
征信服务 |
| 9953006 |
招聘服务 |
| 9953007 |
丧葬服务 |
| 9953008 |
拍卖收藏 |
| 9953009 |
劳务派遣 |
| 9953010 |
灵活用工(税务代缴) |
| 9953011 |
政府补贴 |
| 9953012 |
物业管理 |
| 9954001 |
公共事业(电、气、水) |
| 9954002 |
有线电视缴费 |
| 9954003 |
供暖缴费 |
| 9954004 |
其他生活缴费 |
| 9954005 |
话费充值 |
| 9955001 |
其他商业及生活服务 |
| 9956001 |
数码产品租赁 |
| 9956002 |
机动车租赁 |
| 9956003 |
工业设备租赁 |
| 9956004 |
自有房产出租 |
| 9956005 |
其他租赁 |
| 9957001 |
共享服务 |
| 9957002 |
共享两轮车 |
| 9957003 |
无人值守服务 |
| 9958001 |
宠物领养 |
| 9958002 |
实物消费 |
| 9958003 |
服务消费 |
| 9959001 |
车辆维修养护 |
| 9959002 |
停车服务 |
| 9959003 |
道路救援 |
| 9959004 |
代驾服务 |
| 9960001 |
充换电 |
| 9960002 |
加油卡、加油服务 |
| 9960003 |
加油站、加气站 |
| 9961001 |
ETC缴费 |
| 9961002 |
MTC收费 |
| 9961003 |
高速服务区 |
| 9961004 |
高速公路收费 |
| 9962001 |
出租车客运 |
| 9962002 |
网约车客运 |
| 9962003 |
公共交通 |
| 9962004 |
航空企业 |
| 9962005 |
机场 |
| 9962006 |
机票代理人 |
| 9962007 |
航空系统商 |
| 9962008 |
铁路旅客运输 |
| 9962009 |
公路客运 |
| 9963001 |
物流快递 |
| 9963002 |
驿站/自提柜 |
| 9963003 |
物流平台 |
| 9963004 |
同城即时配送 |
| 9963005 |
仓储 |
| 9963006 |
铁路运输 |
| 9963007 |
船舶海运 |
| 9963008 |
国际货运代理和报关行 |
| 9963009 |
其他运输代理业 |
| 9964001 |
互联网信息检索 |
| 9964002 |
网络推广/网络广告 |
| 9964003 |
信息中介 |
| 9964004 |
互联网基础及增值服务提供商 |
| 9965001 |
软件开发服务 |
| 9965002 |
在线工具 |
| 9965003 |
其他在线应用或综合类服务 |
| 9965004 |
AI服务 |
| 9966001 |
儿童保育服务(公立,含学前教育) |
| 9966002 |
儿童保育服务(民办,含学前教育) |
| 9966003 |
中小学校(公立) |
| 9966004 |
中小学校(民办) |
| 9966005 |
大学与学院(公立) |
| 9966006 |
大学与学院(民办) |
| 9966007 |
其他学校/公立培训机构 |
| 9967001 |
教育管理机构 |
| 9967002 |
教育培训机构(线上) |
| 9967003 |
教育培训机构(线下) |
| 9967004 |
教育培训机构(综合) |
| 9967005 |
少年宫及青少年发展中心 |
| 9967006 |
驾校 |
| 9967007 |
其他教育/培训 |
| 9968001 |
公立医院 |
| 9968002 |
社区卫生服务中心 |
| 9968003 |
专业公共卫生机构 |
| 9968004 |
民营医院 |
| 9968005 |
诊所 |
| 9968006 |
医疗美容 |
| 9968007 |
专科医疗服务 |
| 9968008 |
医学实验室及诊断中心 |
| 9968009 |
线上医疗服务 |
| 9969001 |
护理机构服务 |
| 9969002 |
体检/健康咨询 |
| 9969003 |
其他医疗保健服务 |
| 9970001 |
慈善和社会公益服务 |
| 9970002 |
公益彩票 |
| 9971001 |
政府机构 |
| 9971002 |
行政费用和罚款(非税) |
| 9971003 |
公积金 |
| 9971004 |
公安交管 |
| 9971005 |
医保 |
| 9971006 |
社会保障服务 |
| 9971007 |
政府采购 |
| 9971008 |
文体机构 |
| 9971009 |
政府贷款 |
| 9971010 |
法庭费用 |
| 9971011 |
保释金 |
| 9971012 |
税务 |
| 9971013 |
使领馆 |
| 9971014 |
行业协会和专业社团 |
| 9971015 |
汽车协会 |
| 9971016 |
宗教组织/祠堂/寺庙 |
| 9971017 |
其他会员组织 |
| 9971018 |
中国共产党机关 |
证件类型
| 编码 |
名称 |
| 0 |
居民身份证 |
| 1 |
中国人民解放军军人身份证件 |
| 2 |
港澳居民来往内地通行证 |
| 3 |
台湾居民来往大陆通行证 |
| 4 |
外国公民护照 |
| 5 |
其他类个人身份有效证件 |
| 6 |
单位证件 |
| 7 |
临时居民身份证 |
| 8 |
中国人民武装警察身份证件 |
| 9 |
其他类境内个人身份有效证件 |
| 10 |
其他类境外个人身份有效证件 |
| 11 |
外国人永久居留证 |
| 12 |
港澳居民居住证 |
| 13 |
台湾居民居住证 |
| 21 |
统一社会信用代码(五证合一号码) |
| 22 |
其他类境内机构代码 |
| 23 |
其他类境外机构代码 |
经营模式
零售:
| 编码 |
名称 |
| 01 |
自营类 |
| 02 |
平台类 |
| 03 |
自营+平台 |
| 04 |
入驻平台商家 |
| 05 |
SAAS服务商 |
金融:
| 编码 |
名称 |
| 06 |
金融机构业务 |
| 07 |
金融企业服务 |
| 08 |
助贷机构业务 |
| 09 |
其他金融服务 |
经营大类
| 编码 |
名称 |
| 11001 |
消费金融公司 |
| 11002 |
信托公司 |
| 11003 |
银行 |
| 11004 |
资产管理公司 |
| 11005 |
保险 |
| 11006 |
金融租赁公司 |
| 11007 |
汽车金融公司 |
| 11008 |
小额贷款公司 |
| 11009 |
融资担保公司 |
| 11010 |
融资租赁公司 |
| 11011 |
商业保理公司 |
| 11012 |
助贷机构 |
| 21001 |
零售类商家(实物B2C) |
| 21002 |
集采类商家(实物B2B) |
| 21003 |
服务类商家/服务类商家(B2B) |
| 21004 |
公共民生类 |
| 21005 |
跨境服务贸易 |
| 21006 |
跨境货物贸易 |
经营细类
| 编码 |
名称 |
| 11001001 |
消费金融业务 |
| 11002001 |
信托业务 |
| 11003003 |
其他自营业务 |
| 11003002 |
银行理财业务 |
| 11003004 |
助贷业务 |
| 11003001 |
银行贷款业务 |
| 11004001 |
资产管理服务 |
| 11005002 |
保险代理/经纪公司自营业务 |
| 11005001 |
保险公司自营业务 |
| 11005003 |
信用保证保险业务 |
| 11006001 |
金融租赁业务 |
| 11007001 |
汽车金融业务 |
| 11008001 |
小额贷款业务 |
| 11009001 |
融资担保业务 |
| 11010001 |
融资租赁业务 |
| 11011001 |
商业保理业务 |
| 11012001 |
助贷业务 |
| 21001002 |
线上垂直电商 |
| 21001001 |
线上综合电商 |
| 21001003 |
公域场景电商 |
| 21002001 |
线上综合电商 |
| 21002002 |
线上垂直电商 |
| 21003002 |
餐旅娱乐 |
| 21003004 |
共享经济 |
| 21003006 |
交通物流 |
| 21003008 |
教育培训 |
| 21003001 |
数字娱乐 |
| 21003003 |
商业生活服务 |
| 21003005 |
车辆服务 |
| 21003007 |
网络及软硬件 |
| 21004003 |
公共管理和社会组织 |
| 21004002 |
公益慈善 |
| 21004001 |
医疗健康 |
| 21005001 |
跨境服务贸易 |
| 21006001 |
跨境货物贸易 |
客户文件类型
| 编码 |
名称 |
| 0102211 |
个体营业执照证 |
| 0101104 |
企业营业执照证 |
| 0101401 |
企业银行开户许可证 |
| 0101214 |
个体银行开户许可证 |
| 0102101 |
企业身份证(正) |
| 0102102 |
企业身份证(反) |
| 0102201 |
个体身份证(正) |
| 0102202 |
个体身份证(反) |
| 0314101 |
企业身份证(正) |
| 0314102 |
企业身份证(反) |
| 0314201 |
个体身份证(正) |
| 0314202 |
个体身份证(反) |
| 0401101 |
股东身份证(正) |
| 0401102 |
股东身份证(反) |
| 0401199 |
股东其他证件 |
| 0402201 |
受益人身份证(正) |
| 0402202 |
受益人身份证(反) |
| 0402299 |
受益人其他证件 |
| 9999901 |
社保缴纳证明 |
| 9999902 |
交税证明 |
| 9999999 |
其他附件,补充文件,如特殊经营许可或其他补充材料 |
| 9999914 |
经营场所照片 |
| 9999921 |
APP页面截图 |
| 9999932 |
网站授权函 |
| 9999942 |
联合运营说明函 |
| 9999943 |
小程序页面截图 |
| 9999955 |
公众号截图 |
| 9999972 |
联合运营说明函 |
| 9999976 |
快应用截图 |