会员创建

接口说明
请求参数
会员基础信息createBaseInfo
股东受益人信息shareholdersInfo
会员联系人信息cdpMerchantLinkInfo
会员经营信息cdpMerchantBusinessInfo
经营描述说明
一、业务概述
二、涉及角色、职责及合作方
会员应用场景cdpMerchantContextInfos
会员银行信息cdpMerchantBankInfo
会员文件列表merchantFileInfos
会员其他说明cdpMerchantOtherNoteInfo
其他说明
返回参数
公共报文 - 返回参数
开户申请 - 返回参数 (result)
示例请求 JSON：
示例返回 JSON：

接口说明

宝付商户入网流程：会员创建—>会员创建结果通知—>若会员未创建成功：会员信息修改（补齐会员资料）—>若会员已创建成功：产品开通—>会员签约，此接口在会员创建环节使用。会员创建结果查询接口可用于补偿机制。

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

请求参数

字段名	参数名	类型	必填	描述
申请编号	applyNo	string(32)	Y	申请编号
上级会员号	directUid	string(32)	N	必须为调用方自己或调用方下级会员号
会员类型	merchantType	string(16)	Y	会员类型，INDIVIDUAL：个体商户，COMPANY：企业商户
会员角色	merchantProperties	string(16)	Y	会员角色，AGENT_MEMBER：商户，AGENT_BRANCH：代理商
会员基础信息	createBaseInfo	object	Y	见createBaseInfo
股东受益人信息	shareholdersInfos	array	N	见shareHoldersInfo
会员联系人信息	cdpMerchantLinkInfo	object	Y	见cdpMerchantLinkInfo
会员经营信息	cdpMerchantBusinessInfo	object	Y	见cdpMerchantBusinessInfo
会员应用场景	cdpMerchantContextInfos	array	Y	见cdpMerchantContextInfo
会员银行信息	cdpMerchantBankInfo	object	Y	见cdpMerchantBankInfo
会员文件列表	merchantFileInfos	array	Y	见merchantFileInfo
会员其他说明	cdpMerchantOtherNoteInfo	object	N	见cdpMerchantOtherNoteInfo
创建结果通知地址	notifyUrl	string(512)	N	用于接收会员创建审核结果

会员基础信息createBaseInfo

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

股东受益人信息shareholdersInfo

字段名	参数名	类型	必填	描述
类型	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	联系地址选择法人同股东/受益人，可以不填写，否则必填

会员联系人信息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)	Y	业务联系人手机
业务邮箱	businessEmail	string(32)	Y	业务邮箱

会员经营信息cdpMerchantBusinessInfo

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

经营描述说明

一、业务概述

请描述贵司的业务模式。
比如：

向消费者销售化妆品，向消费者收取货款。
商户向供应商采购汽车，向供应商支付货款等。

二、涉及角色、职责及合作方

需描述贵司在业务中所担任的角色，如涉及合作方，需同时说明合作方角色。
例如：

商户（销售方/付款方/等等）：负责向消费者销售产品（如化妆品）并收取货款、负责向借款方放款、负责向供应商支付等。
合作方（供应商/资金方/等等）：向商户提供商品/服务（如化妆品/物流等），商户需向供应商支付货款、协助资金方回款等。

会员应用场景cdpMerchantContextInfos

字段名	参数名	类型	必填	描述
应用类型	contextType	string(16)	Y	应用类型，1：线下，2：APP，3：网页端，4：小程序，5：H5，6：公众号，7：快应用线下时无需传其余字段
应用名称	contextName	string(32)	C	APP，小程序、公众号、快应用时，填写相应应用名称
链接	contextAdd	string(64)	C	链接地址，移动APP时为：APP下载链接；网页端：PC网站域名；H5：H5链接
备案号	contextBelongNo	string(32)	N	备案号，小程序时：小程序备案号；快应用：快应用备案号

会员银行信息cdpMerchantBankInfo

字段名	参数名	类型	必填	描述
银行卡类型	bankType	string(16)	Y	银行卡类型 1:对私 2:对公
开户名	accountName	string(32)	Y	开户名
开户行名称	bankName	string(32)	Y	开户行名称
银行卡号	bankAccount	string(32)	Y	银行卡号
清算行号	cnapsCode	string(32)	N	对公账户必填
开户地址->省	bankProvince	string(32)	C	银行卡类型对公必填开户地址->省
开户城市	bankCity	string(32)	C	银行卡类型对公必填开户城市
开户行地址	bankAddress	string(64)	C	银行卡类型对公必填开户行地址

会员文件列表merchantFileInfos

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

会员其他说明cdpMerchantOtherNoteInfo

字段名	参数名	类型	必填	描述
补充其他说明	note	string(128)	N	补充其他说明

其他说明

可补充多份证明材料，如特殊行业经营许可证、商家入驻协议、加盟材料等
请上传彩色照片或彩色扫描件或加盖公章鲜章的复印件，要求正面拍摄，露出证件四角且清晰、完整，所有字符清晰可识别，不得反光或遮挡。不得翻拍、截图、镜像、PS涂改。
支持zip/rar/pdf/jpg/png/jpeg/webp/bmp格式，单个文件大小不超过5M。

返回参数

公共报文 - 返回参数

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

开户申请 - 返回参数 (result)

字段名	参数名	类型	必填	描述
会员号	uid	string(32)	Y	会员号

示例请求 JSON：

[header={"parentUid":"13030918","charset":"UTF-8","dgtlEnvlp":"AC5E2072AAF7E9D17FA7013CB607315A4440EA9F1153612C5CE3B32323C7A1C217DF123BEA73019875B94DD691E69AC9BAAF4D3162D2376DF93FD279889471A588AEE30A89EAE7F1B8A83B610C54BC4F8C53F77BBB839B6D42A0D90F5542167CDAF14075103643497E61B906DBD7C197134D3DFD97DBA6179672A7358E7520CB347CEF7804DC4AF78908ED1EEB523B17226211B2F9E748C8C93CD52B5FAD411738492F7E54ED102139167C260E3C17DB30F706B86C41C55D3008CE554A52C2C4DD1336698904813A2F87B054C0C43AAEAF5C1091C7D9B961285F478BBD0E2190A603665C1F9D38ABD3D34B69BC2BFC9A18D16E3FC41EB23AE989C53D6D221030","ncrptnSN":"1139986924","version":"1.0","signSN":"1139986924","verifyType":"11","timestamp":"2025-05-10 17:03:40"}, body={"agentCdpNo":"1300033073","applyNo":"111111112","applySellerId":"3151","businessLine":"RETAIL","cdpMerchantBankInfo":{"accountName":"中国建设银行","bankAccount":"6215584301003030110","bankAddress":"10101010110","bankCity":"陈","bankName":"中国建设银行","bankProvince":"王","bankType":"1","localLogId":"a1682820-96bc-48e7-acdc-74acc6aa33dc","payId":"100003"},"cdpMerchantBusinessInfo":{"businessDesc":"张三","businessPrimaryTypeId":"9993","businessSecondaryTypeId":"9993005","businessType":"01","industryPrimaryTypeId":"9993","industrySecondaryTypeId":"9993005"},"cdpMerchantContextInfos":[{"contextAdd":"http://www.baidu.com","contextFileInfos":[],"contextType":"1","localLogId":"e839b623-caa9-40fc-ae3f-1914d05faa8c","state":"1","transLogId":"contextType","version":"1"}],"cdpMerchantLinkInfo":{"businessEmail":"tianzhuo_wang@baofu.com","businessName":"安安","businessPhone":"1111222333","certificatesExpiryDate":"1984-01-01","certificatesNumber":"9121221","certificatesStartDate":"2025-05-10 12:00:00","certificatesType":"1","version":"1"},"cdpMerchantOtherNoteInfo":{"localLogId":"a9528d9e-2dc6-4c33-866c-47ccbcb6edff","note":"11222中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行中国建设银行"},"createBaseInfo":{"actualOperatingAddress":"上海-上海-浦东新区-居里路991号","address":"上海-上海-浦东新区-居里路991号","addressCity":"上海","addressCountry":"浦东新区","addressProvince":"上海","addressStreet":"居里路991号","businessRelationChannel":"1","companyType":"COMPANY","companyTypeDesc":"企业商户","corporationCertificatesType":"0","currency":"CNY","customerIndustry":"COMPANY","customerIndustryDesc":"企业商户","customerName":"22上海限公司232","establishDate":"2025-05-10 12:00:00.62","idCard":"0","isPublicVerify":"0","legalAddress":"上海-上海-浦东新区-居里路991号","legalEndDate":"2025-05-10 12:00:00.62","legalIsBeneficiary":"0","legalIsLink":"0","legalIsShareholder":"0","legalName":"张三","legalStartDate":"2025-05-10 12:00:00.62","licenseAddress":"上海-上海-浦东新区-居里路991号","licenseNum":"91310115312597774R","linkMobile":"159000000","localLogId":"91c09c22-ffee-4ddb-a72e-1eff22969bcc","merchantProperties":"AGENT_MEMBER","nationality":"CHN","operationEndTerm":"2025-05-10 12:00:00.62","operationStartTerm":"2025-05-10 12:00:00.62","publicVerifyPass":"0","registeredAddress":"上海-上海-浦东新区-居里路991号","registeredCapital":"200000000","telephone":"159000000","verifyType":"1","workingAddress":"111111"},"localLogId":"87819678-9572-433a-a36e-148a784ad6e2","merchantFileInfos":[{"channelEnum":0,"encryptFlag":"2","fileName":"","fileType":"0101401","fileUuid":"ac804e1ba5774606ab7735001071fead","localLogId":"c896cafb-e813-4473-8acf-dbbb6dfabac7","state":"0"},{"channelEnum":0,"customerCode":"","encryptFlag":"2","fileName":"","fileType":"0102101","fileUuid":"ac804e1ba5774606ab7735001071fead","localLogId":"6596efa4-60e2-4a3c-acf7-d2ee89a2aaca","state":"0"},{"channelEnum":0,"encryptFlag":"2","fileName":"","fileType":"0102102","fileUuid":"ac804e1ba5774606ab7735001071fead","localLogId":"651cb811-fa42-4287-961b-fa682bbebb03","state":"0"},{"channelEnum":0,"encryptFlag":"2","fileName":"","fileType":"0101104","fileUuid":"ac804e1ba5774606ab7735001071fead","localLogId":"447c7c40-b6cb-4550-9e34-e0da53be64f7","state":"0"}],"merchantProperties":"AGENT_MEMBER","merchantType":"COMPANY","sellerEmail":"cdp-@test","sellerName":"cdp-@test","sellerPhone":"cdp-@test","shareholdersInfos":[{"address":"张三","beneficiaryBirth":"2110-11-11","beneficiaryMobile":"2111111","certificatesExpiryDate":"2025-05-10 12:00:00.62","certificatesNumber":"张三","certificatesStartDate":"2025-05-10 12:00:00.62","certificatesType":"1","localLogId":"fc78628c-8165-4198-a8cf-9539c0d0f147","name":"张三","shareholdersFileInfos":[{"fileName":"张三","localLogId":"efcf36bf-d017-4f91-afa8-ddbe3661197c"}],"type":"01"},{"address":"张三","beneficiaryBirth":"2110-11-11","beneficiaryMobile":"2111111","certificatesExpiryDate":"2025-05-10 12:00:00.62","certificatesNumber":"张三","certificatesStartDate":"2025-05-10 12:00:00","certificatesType":"1","localLogId":"5ae85695-a008-4b26-a3d9-71e9eed05dca","name":"张三","shareholdersFileInfos":[],"type":"02"}],"transLogId":"629a648c9ada4f79ae23feafe8f8d1f6"}, sign=9BC76C824CCB20C7DF94D83B3229446965894D6E10A9A9639278D8679AA43769FE82EBEAF9F943D65B1EAACA976CA602E874CB7D11F108D88D05279B6ED8DF258BA1627EC884A589E90BCE6B74D633D3AE021CB032DAEC20B459C8C86186172109478536999BC4DFD0924CAFD9CAF9F4C7A5A435C058CA42C58ECAF53D4395A1FE80FBC3896F70BCB0ABA65014621F3E1B5B4B39A87428455AB41EAA892BC0E74127F5C34DD4C00E4E09C334122C44CFFAD3FF8C30942DE9A31B6B24EAF045F2614F5559D105547C7C82EC542BE2089C68D3700027EC4A9F93CC8BC2C719B4A6050092FBEBCF149BEDC2F678A78F4ACA83991DE174E8552B8EAFC10500029177]

示例返回 JSON：

成功示例：

{"body":"{\"success\":true,\"result\":\"1300033838\",\"errorCode\":null,\"errorMsg\":null}","header":"{\"dgtlEnvlp\":\"B0D5DBFC9AB9CD4FB0F166078ED6A8C532F300C9B91FF59D581D980F2F3C67BD8B63C32499D76B7BE5A6C480241BEFB3CB4DBF1DABE2183F0370DB4A6F086938DE908444AD117E13B50412851A4778A6E44875F4CB8B3FBC899C348049F075315E3DDA2A54838F36542FC55C9765977D7AB1357A1A5A5F7D2208ED9AD7A54365BA9FAE25AC2E69C406A78F8C5F90CBBC8D2FE38E1D300DB03AC15516A85038A7D6E480A8D76100A011949C945D531C0F743D74901BA69E661CAD4EA21CB9CAD9430CDE216F9B08FD692B176776A54490F1D191531EC2D4A2B524C5759533A339B6810DE92B05AEEEC9920ABC7467B0139E831C5673D88E48E604C6BA92D097B5\",\"ncrptnSN\":\"1139986924\",\"parentUid\":\"13030918\",\"serviceTp\":\"T-1001-035-18\",\"signSN\":\"1139986924\",\"sysRespCode\":\"S_0000\",\"sysRespDesc\":\"请求正常\",\"verifyType\":\"11\"}","sign":"BFE17FD91668C99A414CBC797DE0CAA1D3BD3E820B5B592123308A7C7D509672C4E13EEFC61000EA70BA7E32F781783160E587188A8A9BB91E52565D9C51B5AC24842F3306806759C88EF3C3A131C57862917C3AA46CE622F09E08CE2C75AD59670735CA6F94AC08BC12E136D10F1303003D74D30CAB52EDD9DAD58C8340270A4703CD3D3222DCCD9DBFAE8A123428F88A56311C5B9DBEA04EA8D3C554D83B881C006DF4F533B0626032CEB669E8EF9D103A8A89DB1432F49711792D54F23A7DBCA725A5685551BDCA32D566B07FBAE84DC53CA3E25C2A326D7A03A344EE2BB030DFA5E8C3FD3417A6025E9819B741E302FEC456A725301A7D14912A2FBA0C17"}

作者：卢珊创建时间：2025-05-15 14:14
最后编辑：admin 更新时间：2026-03-17 19:43