会员信息修改接口文档
|
报文编号 |
版本号 |
请求 |
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 |
快应用截图 |