会员产品开通接口文档
报文编号 | 版本号 | |
---|---|---|
请求 | 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 |
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 | 固定值(元),支持两位小数 |
返回参数
公共报文 - 返回参数
字段名 | 参数名 | 类型 | 必填 | 描述 |
---|---|---|---|---|
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 | 开通成功待完善 |