主题
商户费率信息修改
接口描述
- 接入方通过该接口修改商户费率产品相关信息。
请求URL
/merchant/feeModify
请求方式
- POST
公共请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| appId | 是 | string | appId | 202415629590370906 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号 | 43e2c287-24b1-4cd1-b3d2-e40e7840cc40 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
请求参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| merchantNo | 是 | string | 32 | 商户编号 | XS241113000204 |
| requestNo | 是 | string | 32 | 请求流水号 | 123456789 |
| feeInfo | 是 | string | 费率信息，费用产品列表的json字符串 | [{"endDate":"2099-12-31","feeCode":"ALIPAY","feeFixed":0,"feeRate":"0.6","startDate":"2024-11-13"},{"endDate":"2099-12-31","feeCode":"WXPAY","feeFixed":0,"feeRate":"0.6","startDate":"2024-11-13"}] | |
| - feeCode | 是 | string | 费用产品代码： YOYIPAY_LARGE-甬易支付大额，WITHDRAW-手动提现，ALIPAY-支付宝，WXPAY-微信 | ALIPAY | |
| - feeType | 是 | string | 计费类型： RATE-费率；FIXED-定额；MIX-混合(费率+单笔定额) | RATE | |
| - feeRate | 是 | string | 8 | 费用产品费率(%)，只能设置数字，0.0~0.999999 | 0.60 |
| - feeFixed | 是 | number | 8 | 费用产品固定费(单位分)，0~99999999 | 1 |
| - feePayType | 是 | string | 1 | 手续费收取方式;1-内扣;2-外扣;3-他扣 | 1 |
| - feePayRoleNo | 否 | string | 32 | 手续费支付角色编号(feePayType为3时，必传)，传商户编号或服务商编号 | 1 |
| - feePayRoleType | 否 | string | 10 | 手续费支付角色类型(feePayType为3时，必传)，传商户或服务商角色,MERCHANT-商户;AGENT-服务商 | 1 |
| - topFee | 否 | number | 8 | 费用产品手续费封顶值(单位分)，0~99999999 | 2000 |
| - startDate | 是 | string | 10 | 费用产品开始日期(yyyy-MM-dd) | 2024-01-01 |
| - endDate | 是 | string | 10 | 费用产品结束日期(yyyy-MM-dd) | 2024-12-31 |
请求报文示例
json
{
"appId": "202408554212370909",
"merchantNo": "XS241113000204",
"requestNo": "123456789",
"feeInfo": "[{\"endDate\":\"2099-12-31\",\"feeType\":\"RATE\",\"feeCode\":\"ALIPAY\",\"feeFixed\":0,\"feeRate\":\"0.6\",\"startDate\":\"2024-11-13\"},{\"endDate\":\"2099-12-31\",\"feeType\":\"RATE\",\"feeCode\":\"WXPAY\",\"feeFixed\":0,\"feeRate\":\"0.6\",\"startDate\":\"2024-11-13\"}]",
"signature": "exCsFUiaSptDPtolFklsDx0yHrDGi5u1E9ujvoT/4mMPFW3Vq2criGow0fCh7ZyLRFe4CtYPrE/QH8RypiZtroofmlPytqbZKUX3cBCgOPkac/2Fhx1ffJdYrAhUeBSxtTNVC16kUSLjBn0wlcQr2AvFIj72nAj92MHUHeiQO3INuCYaA3cj8tWw5W5WoCBUWjYpdaxcIbOrJrHGu4yo+JcHoe/u/rxUN8crWXQvnSKdiMIPjigJeZ6S648Heui58ffhLrK7zuUOKwu4JdVBLOq+ta9Q1MUp3KkK6iR1ovqUuK0/lTk/F3QMZiBNdFq4yqMy8GRNSWAA7P99nC85qg==",
"transDate": "1731486017900",
"transNonce": "879df171f3de481d825e1e185638ee22"
}公共响应参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间，13位时间戳 | 1731406784607 |
响应示例
json
{
"code": "00000000",
"message": "成功",
"transDate": "1731486017900",
"transNonce": "879df171f3de481d825e1e185638ee22",
"signature": "exCsFUiaSptDPtolFklsDx0yHrDGi5u1E9ujvoT/4mMPFW3Vq2criGow0fCh7ZyLRFe4CtYPrE/QH8RypiZtroofmlPytqbZKUX3cBCgOPkac/2Fhx1ffJdYrAhUeBSxtTNVC16kUSLjBn0wlcQr2AvFIj72nAj92MHUHeiQO3INuCYaA3cj8tWw5W5WoCBUWjYpdaxcIbOrJrHGu4yo+JcHoe/u/rxUN8crWXQvnSKdiMIPjigJeZ6S648Heui58ffhLrK7zuUOKwu4JdVBLOq+ta9Q1MUp3KkK6iR1ovqUuK0/lTk/F3QMZiBNdFq4yqMy8GRNSWAA7P99nC85qg=="
}备注
- 更多返回错误代码请看 通用规则说明-错误码 的错误代码描述