接口说明
个人会员暂仅支持分账接收方角色。
|
报文编号 |
版本号 |
| 请求 |
XHY1-1001-001-02 |
1.0.0 |
| 应答 |
XHY1-1001-001-02 |
1.0.0 |
请求参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 申请编号 |
applyNo |
string(32) |
Y |
申请编号 |
| 上级会员号 |
directUid |
string(32) |
N |
必须为调用方自己或调用方下级会员号，仅在一代为二代入网商户的场景需要传 |
| 交易主体绑定商户号 |
directBindMemberId |
string(32) |
Y |
仅创建分账接受方：分账接受方将与此商户完成绑定，可接收此商户的分账资金；如果未传，则分账商户和分账接收方之间还需要调用“分账接收方绑定申请”绑定接口，完成分账关系绑定 |
| 会员基础信息 |
createBaseInfo |
object |
Y |
见createBaseInfo |
| 会员经营信息 |
cdpMerchantBusinessInfo |
object |
Y |
见cdpMerchantBusinessInfo |
| 会员银行信息 |
cdpMerchantBankInfo |
object |
Y |
见cdpMerchantBankInfo |
| 会员文件列表 |
merchantFileInfos |
array |
Y |
见merchantFileInfo |
会员基础信息createBaseInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 客户名称 |
customerName |
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 |
身份证证件地址 |
| 经营地址-省份 |
addressProvince |
string(15) |
Y |
经营地址省份 |
| 经营地址-城市 |
addressCity |
string(15) |
Y |
经营地址城市 |
| 经营地址-区 |
addressCountry |
string(32) |
Y |
经营地址区/县 |
| 经营地址-街道 |
addressStreet |
string(32) |
Y |
经营地址街道 |
| 联系邮箱 |
businessEmail |
string(64) |
Y |
办公地址 |
会员经营信息cdpMerchantBusinessInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 客群角色 |
businessType |
string(16) |
Y |
客群角色，见参数说明：客群角色 |
| 经营描述说明 |
businessDesc |
string(128) |
Y |
描述说明见：经营描述说明 |
| 经营大类 |
businessPrimaryTypeId |
string(16) |
Y |
经营大类，枚举值见参数说明：经营大类 |
| 经营细类 |
businessSecondaryTypeId |
string(16) |
Y |
经营细类，枚举值见参数说明：经营细类 |
| 行业细类 |
industrySecondaryTypeId |
string(16) |
Y |
行业细类，枚举值见参数说明：行业细类 |
经营描述说明
一、业务概述
请描述您的业务模式。
比如：
- 向消费者销售化妆品，向消费者收取货款。
- 商户向供应商采购汽车，向供应商支付货款等。
二、涉及角色、职责及合作方
需描述贵司在业务中所担任的角色，如涉及合作方，需同时说明合作方角色。
例如：
- 商户（销售方/付款方/等等）：负责向消费者销售产品（如化妆品）并收取货款、负责向借款方放款、负责向供应商支付等。
- 合作方（供应商/资金方/等等）：向商户提供商品/服务（如化妆品/物流等），商户需向供应商支付货款、协助资金方回款等。
会员银行信息cdpMerchantBankInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 开户名 |
accountName |
string(32) |
Y |
开户名 |
| 开户行名称 |
bankName |
string(32) |
Y |
开户行名称 |
| 银行卡号 |
bankAccount |
string(32) |
Y |
银行卡号 |
会员文件列表merchantFileInfos
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 文件类别 |
fileType |
string(16) |
N |
文件类别，见参数说明：文件类型 |
| 文件uuid |
fileUuid |
string(32) |
N |
文件uuid，个人需要上传法人身份证人像面、国徽面、银行卡卡号面、 |
其他说明
- 可补充多份证明材料，如特殊行业经营许可证、商家入驻协议、加盟材料等
- 请上传彩色照片或彩色扫描件或加盖公章鲜章的复印件，要求正面拍摄，露出证件四角且清晰、完整，所有字符清晰可识别，不得反光或遮挡。不得翻拍、截图、镜像、PS涂改。
- 分账关系绑定必须上传相关材料作为资金往来依据，需其他文件9999999补充文件
- 分账资金往来依据可选材料：
方案1：分账商户和接收方之间的合作协议（需双方签字盖章）；
方案2：分账接收方在系统内的截图信息和分账商户主体盖章的挂网协议（两件都必传） - 支持zip/rar/pdf/jpg/png/jpeg/webp/bmp格式，单个文件大小不超过20M。
返回参数
公共报文 - 返回参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| errorCode |
返回码 |
string(64) |
C |
|
| errorMsg |
返回信息 |
string(32) |
C |
|
| success |
响应状态 |
Boolean |
Y |
true：响应成功 false：业务异常 |
| result |
返回参数 |
json |
C |
见下方开户申请返回参数 |
开户申请 - 返回参数 (result)
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 会员号 |
uid |
string(32) |
Y |
会员号 |
| 商户号 |
memberId |
string(32) |
Y |
交易商户号 |
| 终端号 |
terminalId |
string(32) |
Y |
交易终端号 |
| 审批状态 |
approveState |
string(32) |
Y |
当前审批状态 |
示例请求 JSON：
示例返回 JSON：
成功示例：
作者：admin 创建时间：2026-06-05 16:21
最后编辑：admin 更新时间：2026-06-17 13:43
