会员产品开通接口文档

报文编号 版本号
请求 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 线下签约
产品计费规则集合 feeRuleList array Y 前端传入的协议模版中计费规则集合，集合对象见apiAgreementFeeRuleInfo
产品扩展信息 prodExtendinfo obiect N 产品扩展信息，具体字段见prodExtendInfo

apiAgreementFeeRuleInfo

字段名 参数名 类型 必填 描述
协议签署产品货架编号 productModelId string(32) Y 产品货架编号：多渠道收付款默认：M2503000001
(注：开通多渠道收付款产品，需要提供以下材料：线上店铺截图、店铺二维码截图、后台订单截图、公域平台后台店铺截图、供货合作协议/转账凭证或代运营协议。附件可上传到客户文件列表merchantFileInfos。截图类文件类型可使用9999921:APP页面截图，附件类文件类型可使用9999999:其他附件
产品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

字段名 参数名 类型 必填 描述
银行类型 bankType string(16) N 银行类型，默认 SSQY(苏商)，多渠道收款业务适用

返回参数

公共报文 - 返回参数

字段名 参数名 类型 必填 描述
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
最后编辑：闫婷  更新时间：2025-08-01 09:14