跳转到主要内容
POST
/
rate
/
commission_rule
/
upgrade
更新费用规则
curl --request POST \
  --url https://openplatform.gateapi.io/rate/commission_rule/upgrade \
  --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 '
{
  "r_markup": 0.002,
  "effective_date": "2026-05-01 00:00:00"
}
'
{
  "status": "SUCCESS",
  "code": "000000",
  "errorMessage": "",
  "data": {
    "config_id": "cfg_202605010001",
    "previous_config_id": "cfg_existing_xxx",
    "version_no": 2,
    "sub_merchant_id": "123456789",
    "r_markup": 0.002,
    "f_markup": 1,
    "status": "PENDING_EFFECTIVE",
    "effective_date": "2026-05-01 00:00:00",
    "due_date": null,
    "created_at": "2026-04-17T09:00:00Z",
    "updated_at": "2026-04-17T09:00:00Z"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.gate.com/llms.txt

Use this file to discover all available pages before exploring further.

概述

本页介绍机构主商户通过新建版本方式更新子账户费用规则的接口。完整字段、请求体与响应示例由上方 OpenAPI 定义渲染。

说明

  • 本接口将新建一条规则版本;创建成功不会立即变更当前生效规则,但会将未生效版本(如有)置为失效。新版本生效时,将整体替换当前生效规则。
  • 本接口使用 X-GatePay-MerchantId 标识主商户上下文,不使用 X-GatePay-On-Behalf-Of
  • 请求体中使用 sub_merchant_id 指定待更新的子账户,不再使用 config_id 作为更新入参。

请求头

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.002

effective_date
string
必填

新版本生效时间,格式 yyyy-MM-dd HH:mm:ss;需精确到秒。

示例:

"2026-05-01 00:00:00"

f_markup
number

新的固定额加价(USDT),默认 0

示例:

1

due_date
string | null

新版本失效时间,格式与 effective_date 相同;不传表示长期有效。

示例:

null

响应

200 - application/json

成功响应。

status
enum<string>

接口处理状态。

可用选项:
SUCCESS,
FAIL
code
string

业务结果码。

示例:

"000000"

errorMessage
string

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

示例:

""

data
object