商户刷卡费率变更
1、修订记录
| 修订记录 | 日期 | 说明 | 作者 |
|---|---|---|---|
| 1.0 | 2022.04.01 | 初稿 | 康俊锋 |
2、业务说明
（1）接口说明
扫码服务商商户进件成功后，需要变更商户的工作日到账、天天到 账、实时到账等等刷卡费率可以通过本接口实现，变更任何信息都需上传“商户信息变更申请表”图片。
3、请求地址
| 环境 | HTTPS请求地址 |
|---|---|
| 测试环境 | https://appdev.ysepay.com/saas/org/changeMerPosFee |
| 正式环境 | https://ouser.ysepay.com:6443/saas/org/changeMerPosFee |
4、请求参数说明
4.1、公共请求参数
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| ver | String(3) | Y | 版本号 固定值1.0 |
| src | String(50) | Y | 由银盛生成的接入机构号，请联系银盛客户经理获取。示例值：ORG20210427160753 |
| msgCode | String(20) | Y | 接口代码 固定值Merchant |
| method | String(30) | Y | 接口方法 固定值changeMerPosFee |
| signType | String(10) | Y | 报文签名算法，RSA、SM 注：应监管要求签名算法变更为国密，新接入商户请选择SM |
| charset | String(10) | Y | 字符集 固定值UTF-8 |
| reqFlowId | String(20) | Y | 请求流水号，示例值：202110011944011101 注意：该字段不参与签名 |
| signValue | String | Y | 签名串，请参考”签名样例以及demo下载“。 |
| data | String | Y | 业务参数（des加密成密文字符串） |
4.2、业务请求参数
data加密前的json数据明文字符串
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| mercId | String(20) | Y | 银盛商户号 |
| posT1AcctFee | Object | N | 工作日到账费率，参数详情 |
| posD1AcctFee | Object | N | 天天到账费率，参数详情 |
| posD0AcctFee | Object | N | 实时到账费率，参数详情 |
| applicationContractType | String | N | 变更申请表类型 1=纸质 2=电子 注:2电子不需要上传变更申请表，为空则默认是纸质 |
4.3 工作日到账费率具体参数（posT1AcctFee）
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| t111Rate | String(10) | Y | 工作日到账- 借记卡费率 如：0.01%，填 0.01 |
| t111RateTop | String(15) | Y | 工作日到账-借记卡费率封顶，单位：分 如：0.01 元，填写 1 |
| t111SignRateMin | String(15) | Y | 工作日到账-借记卡费率封底，单位：分 如：0.01 元，填写 1 |
| t112Rate | String(10) | Y | 工作日到账-贷记卡费率 如：0.01%，填 0.01 |
| t112SignRateMin | String(15) | Y | 工作日到账- 贷记卡费率封底，单位：分 如：0.01 元，填写 1 |
4.4 天天到账费率具体参数（posD1AcctFee）
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| t11Rate | String(10) | Y | 天天到账-借记卡费率 如：0.01%，填 0.01 |
| t11RateTop | String(15) | Y | 天天到账-借记卡费率封顶，单位：分 如：0.01元，填写1 |
| t11SignRateMin | String(15) | Y | 天天到账-借记卡费率封底，单位：分 如：0.01元，填写1 |
| t12Rate | String(10) | Y | 天天到账-贷记卡费率 如：0.01%，填写0.01 |
| t12SignRateMin | String(15) | Y | 天天到账-贷记卡费率封底，单位：分 如：0.01元，填写0.01 |
4.5 实时到账费率具体参数（posD0AcctFee）
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| d011Rate | String(10) | Y | 实时到账-借记卡费率 如：0.01%，填 0.01 |
| d011RateTop | String(15) | Y | 实时到账-借记卡费率封顶，单位：分 如：0.01元，填写1 |
| d011RateBottom | String(15) | Y | 实时到账-借记卡费率封底，单位：分 如：0.01 元，填写1 |
| d012Rate | String(10) | Y | 实时到账-贷记卡费率 如：0.01%，填 0.01 |
| d012RateBottom | String(15) | Y | 实时到账-贷记卡费率封底，单位：分 如：0.01 元，填写 1 |
| d0AdvanceJsignType | String(10) | Y | 实时到账-借记卡签约费率垫资费类型 只能是百分比 或者元 |
| d0AdvanceJsignFee | String(10) | Y | 实时到账-借记卡签约费率垫资费 实时到账-借记卡签约费率垫资费类型为百分比时填写费率，如：0.01%，填 0.01；实时到账-借记卡签约费率垫资费类型为元时填写金额单位：分，如：0.01 元， 填写 1 |
| d0AdvanceJsignMax | String(15) | N | 实时到账-借记卡签约费率垫资费封顶 实时到账-借记卡签约费率垫资费类型为百分比时必填 单位： 分，如：0.01 元，填写 1 |
| d0AdvanceJsignMin | String(15) | N | 实时到账-借记卡签约费率垫资费封底 实时到账-借记卡签约费率垫资费类型为百分比时必填 单位： 分，如：0.01 元，填写 1 |
| d0AdvanceDsignType | String(10) | Y | 实时到账-贷记卡签约费率垫资费类型 只能是百分比或者元 |
| d0AdvanceDsignFee | String(10) | Y | 实时到账-贷记卡签约费率垫资费 实时到账-贷记卡签约费率垫资费类型为百分比时填写费率，如：0.01%，填 0.01；实时到账-贷记卡签约费率垫资费类型为元时填写金额 单 位：分，如：0.01 元， 填写 1 |
| d0AdvanceDsignMax | String(15) | N | 实时到账-贷记卡签约费率垫资费封顶 实时到账-贷记卡签 约费率垫资费类型为 百分比时必填 单位： 分，如：0.01 元，填写 1 |
| d0AdvanceDsignMin | String(15) | N | 实时到账-贷记卡签约费率垫资费封底 实时到账-贷记卡签 约费率垫资费类型为 百分比时必填 单位： 分，如：0.01 元，填写 1 |
5.响应参数说明
银盛支付对商户的请求数据处理完成后，会将处理的结果数据同步回执给商户。
请注意：银盛后期会对返回参数保留扩展的权力，扩展方式为新增参数但不会删除参数，请商户在解析银盛返回参数时要支持银盛可能扩展参数这种情况。
5.1、公共响应参数
| 参数 | 类型(长度） | 必填 | 参数说明 |
|---|---|---|---|
| ver | String(3) | Y | 版本号 固定值1.0 |
| src | String(50) | Y | 由银盛生成的接入机构号，请联系银盛客户经理获取。示例值：ORG20210427160753 |
| msgCode | String(20) | Y | 接口代码 固定值Merchant |
| method | String(30) | Y | 接口方法 固定值changeMerPosFee |
| signType | String(10) | Y | 报文签名算法，RSA、SM 注：应监管要求签名算法变更为国密，新接入商户请选择SM |
| charset | String(10) | Y | 字符集 固定值UTF-8 |
| reqFlowId | String(20) | Y | 请求流水号，示例值：202110011944011101 注意：该字段不参与签名 |
| signValue | String | Y | 签名串，请参考”签名样例以及demo下载“。 |
| data | String | Y | 业务参数（JSON数据） |
5.2、业务响应参数
data(JSON数据)
| 参数 | 类型(字节长度） | 必填 | 参数说明 |
|---|---|---|---|
| changeFlowId | String(50) | N | 合作方系统变更流水，00-成功时返回 |
| code | String(2) | Y | 返回码（00-成功；50-超时；99-失败） |
| note | String(100) | Y | 返回码说明，返回信息描述 |
{"code":200,"message":"成功","data":null,"list":null}