跳转到主要内容
POST
/
rate
/
commission_rule
创建费用规则
curl --request POST \
  --url https://openplatform.gateapi.io/rate/commission_rule \
  --header 'Content-Type: application/json' \
  --header 'X-GatePay-Certificate-ClientId: <x-gatepay-certificate-clientid>' \
  --header 'X-GatePay-MerchantId: <x-gatepay-merchantid>' \
  --header 'X-GatePay-Nonce: <x-gatepay-nonce>' \
  --header 'X-GatePay-Signature: <x-gatepay-signature>' \
  --header 'X-GatePay-Timestamp: <x-gatepay-timestamp>' \
  --data '
{
  "sub_merchant_id": "123456789",
  "r_markup": 0.001,
  "effective_date": "2026-04-17 00:00:00"
}
'
{
  "status": "SUCCESS",
  "code": "000000",
  "errorMessage": "",
  "data": {
    "config_id": "cfg_202604170001",
    "previous_config_id": null,
    "version_no": 1,
    "sub_merchant_id": "123456789",
    "r_markup": 0.001,
    "f_markup": 0,
    "status": "PENDING_EFFECTIVE",
    "effective_date": "2026-04-17 00:00:00",
    "due_date": "2026-12-31 23:59:59",
    "created_at": "2026-04-16T16:10:00Z",
    "updated_at": "2026-04-16T16:10:00Z"
  }
}

​
概述

本页介绍机构主商户首次为子账户创建 Markup 规则的接口。完整字段、请求体与响应示例由上方 OpenAPI 定义渲染。

​
说明

  • 为指定子账户首次创建加价（下文统称为 Markup）规则。创建成功后，该子账户交易将在底价基础上叠加 Markup 计费。
  • 本接口使用 X-GatePay-MerchantId 标识主商户上下文，不使用 X-GatePay-On-Behalf-Of。
  • 若该子账户已存在生效中或待生效规则，应改用“升级费用规则版本”接口。

请求头

​
X-GatePay-Certificate-ClientId
string
必填

应用 ClientId。

​
X-GatePay-Signature
string
必填

使用 Payment API Secret 生成的 HMAC-SHA512 签名。

​
X-GatePay-Timestamp
string
必填

UTC 毫秒时间戳。

​
X-GatePay-Nonce
string
必填

随机字符串，用于防重放。

​
X-GatePay-MerchantId
string
必填

主商户 ID。该接口组通过此请求头声明当前机构主商户上下文。

请求体

application/json
​
sub_merchant_id
string
必填

子账户 ID。

示例:

"123456789"

​
r_markup
number
必填

百分比加价，不可为 null，可传 0。

示例:

0.001

​
effective_date
string
必填

生效时间，格式 yyyy-MM-dd HH:mm:ss。

示例:

"2026-04-17 00:00:00"

​
f_markup
number

固定额加价（USDT）。不传时按 0 处理。

示例:

0

​
due_date
string | null

失效时间，格式与 effective_date 相同；不传表示长期有效。

示例:

"2026-12-31 23:59:59"

响应

200 - application/json

成功响应。

​
status
enum<string>

接口处理状态。

可用选项:
SUCCESS,
FAIL
​
code
string

业务结果码。

示例:

"000000"

​
errorMessage
string

错误信息；成功时为空字符串。

示例:

""

​
data
object