产品开通
接口说明
宝付商户入网流程：会员创建—>产品开通—>会员签约，此接口在产品开通环节使用。
|
报文编号 |
版本号 |
| 请求 |
XHY1-1007-001-01 |
1.0.0 |
| 应答 |
XHY1-1007-001-01 |
1.0.0 |
请求参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 会员号 |
uid |
string(32) |
Y |
会员编号 |
| 申请编号 |
applySerialNo |
string(32) |
Y |
申请编号 |
| 协议签署方式 |
signedWay |
string(16) |
Y |
协议签署方式，1 线上签约，2 线下签约 |
| 协议通知方式 |
signedFun |
string(16) |
Y |
协议签署方式，1:短信 2邮件 |
| 产品计费规则集合 |
feeRuleList |
array |
Y |
前端传入的协议模版中计费规则集合，集合对象见feeRuleList |
| 产品扩展信息 |
prodExtendInfo |
obiect |
N |
产品扩展信息，具体字段见prodExtendInfo |
| 开通结果通知地址 |
notifyUrl |
string(512) |
N |
用于接收产品开通进度及结果 |
产品计费规则集合feeRuleList
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 开通产品货架编号 |
productModelId |
string(32) |
Y |
见参数说明：产品货架编号 |
| 产品id |
productId |
string(32) |
Y |
见参数说明：产品货架编号 |
| 计费账户 |
feeAcctId |
string(32) |
Y |
计费账户，默认 1：基本账户（开通普通收单产品时，计费账户请传1）；6：待分账户（已开通分账产品时，计费账户请传6）；7：分账接受户； |
| 开始有效日期 |
beginEffectiveTime |
string(32) |
Y |
开始有效日期，yyyy-MM-dd |
| 计费模式 |
billModel |
string(16) |
Y |
计费模式，1：费率模式，2：固定值模式 |
| 按费率计费策略 |
rateRuleStrategyList |
array |
C |
按费率计费策略，billModel为1必填 |
| 按固定值计费策略 |
amountAgreementFeeStrategyList |
array |
C |
按固定值计费策略，billModel为2必填 |
按费率计费策略rateRuleStrategyList
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| –费率 |
feeRate |
string(16) |
Y |
费率，五位小数 |
| –最低目标收费 |
minFee |
string(16) |
Y |
最低目标收费（元），支持两位小数 |
| –最高目标收费 |
maxFee |
string(16) |
Y |
最高目标收费（元），支持两位小数 |
按固定值计费策略amountAgreementFeeStrategyList
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 固定值 |
baseRee |
string(16) |
Y |
固定值（元），支持两位小数 |
产品扩展信息prodExtendInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 银行类型 |
bankType |
string(16) |
N |
银行类型，SSQY苏商，HT华通，默认SSQY(苏商) |
| 产品补充信息 |
openSupplyInfo |
obiect |
C |
分账类或聚合产品必传 |
产品补充信息 openSupplyInfo
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 是否申请微信服务商 |
wechatMerchApplyFlag |
Integer |
C |
微信产品必传，是否通过宝付申请,取值： 0：否，1：是 |
| 微信绑定appId集合 |
wxAppIdSet |
array |
N |
wechatMerchApplyFlag=0时，设置绑定数量最多5个 |
| 微信绑定授权目录集合 |
wxAuthUrlSet |
array |
N |
wechatMerchApplyFlag=0时，设置绑定数量最多5个 |
| 是否自有支付宝服务商 |
aliMerchOwnerFlag |
Integer |
C |
支付宝产品必传, 取值：0：否，1：是 |
| 支付宝商户名称 |
aliMerchantName |
string(64) |
C |
aliMerchOwnerFlag=1必传 |
| 支付宝商户号 |
aliMerchantNo |
string(64) |
C |
aliMerchOwnerFlag=1必传 |
| 分账比例 |
shareProdRatio |
BigDecimal |
C |
订单分账产品必传, 支持位小数 取值范围：(0, 100]；余额分账上传100即可 |
| 否申请技术支持 |
techSupportFlag |
Integer |
N |
取值：0：否（默认），1：是 |
| 补充附件列表 |
supplyFiles |
array |
N |
产品开通补充附件 |
产品开通补充附件 supplyFiles
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 文件类别 |
fileType |
string(16) |
N |
文件类别，见参数说明：文件类型 |
| 文件uuid |
fileUuid |
string(32) |
N |
文件uuid |
返回参数
公共报文 - 返回参数
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| errorCode |
返回码 |
string(64) |
C |
|
| errorMsg |
返回信息 |
string(32) |
C |
|
| success |
响应状态 |
Boolean |
Y |
true：响应成功 false：业务异常 |
| result |
返回参数 |
json |
C |
见下方开户申请返回参数 |
产品开通 - 返回参数 (result)
| 字段名 |
参数名 |
类型 |
必填 |
描述 |
| 开通状态 |
openState |
string(32) |
N |
开通状态，见附录：开通状态 |
| 开通编号 |
openApplyNo |
string(32) |
N |
开通编号 |
说明：
示例请求 JSON：
示例返回 JSON：
成功示例：
附录
开通状态
| 编码 |
名称 |
| 0 |
未开通 |
| 1 |
开通中 |
| 2 |
开通成功 |
| 3 |
开通失败 |
| 4 |
已撤销 |
| 5 |
开通成功待完善 |
作者：卢珊 创建时间：2025-06-19 13:52
最后编辑：admin 更新时间：2026-06-16 23:11
