商户进件接口文档
请求参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 申请编号 |
applyNo |
string(32) |
Y |
申请编号 |
| 会员类型 |
merchantType |
string(16) |
Y |
会员类型，INDIVIDUAL：个体商户，COMPANY：企业商户 |
| 申请类型 |
merchantProperties |
string(16) |
Y |
申请类型，AGENT_MEMBER：普通商户，AGENT_BRANCH：代理商 |
| 业务线 |
businessLine |
string(16) |
Y |
业务线，FINANCE：金融，RETAIL：零售 |
| 企业商户创建基础参数 |
createBaseInfo |
object |
Y |
企业商户创建基础参数，见createBaseInfo |
| 股东、受益人信息 |
shareholdersInfos |
array |
Y |
股东、受益人信息，见shareHoldersInfo |
| 客户经营场所 |
cdpMerchantContextInfos |
array |
Y |
客户经营场所，见cdpMerchantContextInfo |
| 客户文件列表 |
merchantFileInfos |
array |
Y |
客户文件列表，见merchantFileInfo |
| 客户银行信息 |
cdpMerchantBankInfo |
object |
Y |
客户银行信息，见cdpMerchantBankInfo |
| 客户联系人信息 |
cdpMerchantLinkInfo |
object |
Y |
客户联系人信息，见cdpMerchantLinkInfo |
| 客户经营信息 |
cdpMerchantBusinessInfo |
object |
Y |
客户经营信息，见cdpMerchantBusinessInfo |
| 客户其他说明 |
cdpMerchantOtherNoteInfo |
object |
N |
客户其他说明，见cdpMerchantOtherNoteInfo |
| 协议签署申请 |
apiAgreementSignApplyInfo |
object |
N |
协议签署申请，见apiAgreementSignApplyInfo |
createBaseInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 客户名称 |
customerName |
string(32) |
Y |
客户名称 |
| 营业执照号 |
licenseNum |
string(32) |
Y |
营业执照号 |
| 营业执照所在地 |
licenseAddress |
string(64) |
N |
营业执照所在地 |
| 营业开始时间 |
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) |
N |
法人代表归属地 |
| 实际经营地址 |
actualOperatingAddress |
string(32) |
N |
实际经营地址 |
| 办公地址 |
workingAddress |
string(32) |
Y |
办公地址 |
| 注册地址 |
registeredAddress |
string(32) |
N |
注册地址 |
| 联系地址 |
address |
string(64) |
N |
联系地址 |
| 法人是否为受益人 |
legalIsBeneficiary |
string(16) |
N |
法人是否为受益人 1：是 0 否， 默认：0 |
| 法人是否为业务联系人 |
legalIsLink |
string(16) |
N |
法人是否为业务联系人 1：是 0 否， 默认：0 |
| 法人是否为股东 |
legalIsShareholder |
string(16) |
N |
法人是否为股东 1：是 0 否， 默认：0 |
shareholdersInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 类型 |
type |
string(16) |
Y |
类型，01-控股股东，02-受益人 |
| 股东\受益人名称 |
name |
string(32) |
Y |
股东受益人名称 |
| 证件种类 |
certificatesType |
string(16) |
Y |
证件种类，见附录：证件类型 |
| 手机号 |
beneficiaryMobile |
string(16) |
Y |
手机号 |
| 证件号码 |
certificatesNumber |
string(32) |
Y |
证件号码(加密) |
| 证件有效期 |
certificatesStartDate |
string(16) |
Y |
控股股东证件有效期，yyyy-MM-dd |
| 证件过期时间 |
certificatesExpiryDate |
string(16) |
Y |
证件过期时间，yyyy-MM-dd（长期传9999-12-30） |
| 出生日期 |
beneficiaryBirth |
string(16) |
N |
出生日期，yyyy-MM-dd |
| 联系地址 |
address |
string(64) |
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 |
备案号，小程序时：小程序备案号；快应用：快应用备案号 |
merchantFileInfos
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 文件类别 |
fileType |
string(16) |
N |
文件类别，见附录：客户文件类型 |
| 文件uuid |
fileUuid |
string(32) |
N |
文件uuid |
cdpMerchantBankInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 银行卡类型 |
bankType |
string(16) |
Y |
银行卡类型 1:对私 2:对公 |
| 卡类型 |
cardType |
string(16) |
N |
卡类型 默认传 借记卡： 1 |
| 开户名 |
accountName |
string(32) |
Y |
开户名 |
| 开户行名称 |
bankName |
string(32) |
Y |
开户行名称 |
| 银行卡号 |
bankAccount |
string(32) |
Y |
银行卡号 |
| 开户地址->省 |
bankProvince |
string(32) |
N |
开户地址->省 |
| 开户城市 |
bankCity |
string(32) |
N |
开户城市 |
| 开户行地址 |
bankAddress |
string(64) |
N |
开户行地址 |
| 联行号 |
cnapsCode |
string(32) |
N |
联行号 |
cdpMerchantLinkInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 业务联系人 |
businessName |
string(32) |
Y |
业务联系人 |
| 证件种类 |
certificatesType |
string(16) |
Y |
证件种类，见附录：证件类型 |
| 证件号码 |
certificatesNumber |
string(32) |
Y |
证件号码 |
| 证件有效期 |
certificatesExpiryDate |
string(16) |
Y |
证件有效期，yyyy-MM-dd |
| 证件过期时间 |
certificatesStartDate |
string(16) |
Y |
证件有效期过期时间，yyyy-MM-dd，长期传9999-12-30 |
| 业务电话 |
businessPhone |
string(16) |
Y |
业务电话 |
| 业务邮箱 |
businessEmail |
string(32) |
N |
业务邮箱 |
cdpMerchantBusinessInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 经营模式 |
businessType |
string(16) |
Y |
经营模式，见附录：经营模式 |
| 经营描述说明 |
businessDesc |
string(128) |
Y |
描述说明见：经营描述说明 |
| 经营大类 |
businessPrimaryTypeId |
string(16) |
Y |
经营大类，枚举值见附录：经营大类 |
| 经营细类 |
businessSecondaryTypeId |
string(16) |
Y |
经营细类，枚举值见附录：经营细类 |
| 行业大类 |
industryTypeId |
string(16) |
Y |
行业细类，枚举值见附录：宝付新细分类 |
| 行业细类 |
industrySecondaryTypeId |
string(16) |
Y |
行业细类，枚举值见附录：宝付新细分类 |
经营描述说明
一、业务概述 请描述贵司的业务模式。比如：向消费者销售化妆品，向消费者收取货款。商户向供应商采购汽车，向供应商支付货款等
二、涉及角色、职责及合作方 需描述贵司在业务中所担任的角色，如涉及合作方，需同时说明合作方角色。 例如： 商户（销售方/付款方/等等）：负责向消费者销售产品（如化妆品）并收取货款/负责向借款方放款/负责向供应商支付/等等。 合作方（供应商/资金方/等等）：向商户提供商品/服务（如化妆品/物流等），商户需向供应商支付货款/协助资金方回款/等等
cdpMerchantOtherNoteInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 补充其他说明 |
note |
string(128) |
N |
补充其他说明 |
补充说明
- 可补充多份证明材料，如特殊行业经营许可证、商家入驻协议、加盟材料等
- 请上传彩色照片或彩色扫描件或加盖公章鲜章的复印件，要求正面拍摄，露出证件四角且清晰、完整，所有字符清晰可识别，不得反光或遮挡。不得翻拍、截图、镜像、PS涂改。
- 支持zip/rar/pdf/jpg/png/jpeg/webp/bmp格式，单个文件大小不超过5M。
apiAgreementSignApplyInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 协议签署方式 |
signedWay |
string(16) |
Y |
协议签署方式，1 线上签约，2 线下签约 (注：申请类型：merchantProperties是AGENT_BRANCH：代理商时，协议签署模式只支持 ** 2 线下签约 ** |
| 产品计费规则集合 |
feeRuleList |
array |
Y |
产品计费规则集合，见apiAgreementFeeRuleInfo |
| 银行类型 |
bankType |
string(16) |
N |
银行类型，默认 SSQY（苏商） |
| 产品扩展信息 |
prodExtendinfo |
obiect |
N |
产品扩展信息，具体字段见prodExtendInfo |
feeRuleList
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 协议签署产品货架编号 |
productModelId |
string(32) |
Y |
产品货架编号：多渠道收款默认：M2503000001 |
| 产品id |
productId |
string(32) |
Y |
产品id ：多渠道收款默认四个产品，分别,104：线下打款 210:工作日转账 211：工作日晚上转账 212 节假日到账 |
| 计费账户 |
feeAcctId |
string(32) |
Y |
计费账户，默认 1：基本账户 |
| 开始有效日期 |
beginEffectiveTime |
string(32) |
Y |
开始有效日期，yyyy-MM-dd |
| 计费模式 |
billModel |
string(16) |
Y |
计费模式，1：费率模式，2：固定值模式 |
| 按费率计费策略 |
rateRuleStrategyList |
array |
C |
按费率计费策略，billModel为1必填，具体字段见rateRuleStrategyList |
| 按固定值计费策略 |
amountAgreementFeeStrategyList |
array |
C |
按固定值计费策略，billModel为2必填，具体字段见amountAgreementFeeStrategyList |
rateRuleStrategyList
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 费率 |
feeRate |
string(16) |
Y |
费率，五位小数 |
| 最低目标收费 |
minFee |
string(16) |
Y |
最低目标收费（元），支持两位小数 |
| 最高目标收费 |
maxFee |
string(16) |
Y |
最高目标收费（元），支持两位小数 |
amountAgreementFeeStrategyList
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 固定值 |
baseRee |
string(16) |
Y |
固定值（元），支持两位小数 |
产品扩展信息prodExtendInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 股东受益人信息补充 |
shareholdersInfo |
list |
N |
详见shareholdersInfo补充字段 |
shareholdersInfo补充字段
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 收益所有人姓名 |
beneficiaryName |
string(512) |
N |
bankType为SSQY(苏商企业号)时必填 |
| 证件种类 |
certificatesType |
string(16) |
N |
证件种类，见参数说明：证件类型
bankType为SSQY(苏商企业号)时必填 |
| 证件号码 |
certificatesNumber |
string(32) |
N |
bankType为SSQY(苏商企业号)时必填 |
| 受益人地址 |
beneficiaryAddress |
string(512) |
N |
bankType为SSQY(苏商企业号)时必填 |
| 受益所有人证件正面影像照 |
beneficiaryIdFrontPicId |
string(100) |
N |
bankType为SSQY(苏商企业号)时必填，填入文件上传接口返回的文件ID |
| 受益所有人证件反面影像照 |
beneficiaryIdBackPicId |
string(100) |
N |
bankType为SSQY(苏商企业号)时必填，填入文件上传接口返回的文件ID |
| 性别 |
beneficiaryGender |
string(1) |
N |
bankType为SSQY(苏商企业号)时必填，1-男 2-女 |
| 国籍 |
beneficiaryCountryCd |
string(3) |
N |
bankType为SSQY(苏商企业号)时必填，156-中国 |
| 出生日期 |
beneficiaryBirthDt |
string(10) |
N |
bankType为SSQY(苏商企业号)时必填，格式：yyyy-MM-dd |
| 受益所有权关系类型 |
beneficiaryRelType |
string(1) |
N |
bankType为SSQY(苏商企业号)时必填
1-25%以上股权或股份；
2-25%以上合伙权益；
3-25%以上收益权；
4-25%以上表决权；
5-实际控制；
6-日常经营管理 |
| 受益所有人关系开始时间 |
beneficiaryRelStartDt |
string(10) |
N |
bankType为SSQY(苏商企业号)时必填，格式：yyyy-MM-dd |
| 受益所有人关系终止时间 |
beneficiaryRelEndDt |
string(10) |
N |
bankType为SSQY(苏商企业号)时必填，格式：yyyy-MM-dd |
返回参数
公共报文 - 返回参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| errorCode |
返回码 |
string(64) |
C |
|
| errorMsg |
返回信息 |
string(32) |
C |
|
| success |
响应状态 |
Boolean |
Y |
true：响应成功 false：业务异常 |
| result |
返回参数 |
json |
C |
见下方开户申请返回参数 |
开户申请 - 返回参数 (result)
申请编号
说明：
示例请求 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"}
