跳转到主要内容
POST
/
rate
/
commission_rule
/
list
查询费用规则列表
curl --request POST \
  --url https://openplatform.gateapi.io/rate/commission_rule/list \
  --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 '
{
  "pageNum": 1,
  "pageSize": 20,
  "has_markup": true,
  "status": "EFFECTIVE",
  "sub_merchant_id": "123456789"
}
'
{
  "status": "SUCCESS",
  "code": "000000",
  "errorMessage": "",
  "data": {
    "records": [
      {
        "sub_merchant_id": "123456789",
        "has_markup": true,
        "r_markup": 0.001,
        "f_markup": 0,
        "actual_rate": {
          "r_total": 0.0035,
          "f_total": 1
        },
        "status": "EFFECTIVE",
        "effective_date": "2026-04-17 00:00:00",
        "due_date": null,
        "updated_at": "2026-04-17T08:00:00Z"
      }
    ],
    "total": 48,
    "size": 20,
    "current": 1,
    "pages": 3
  }
}

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 定义渲染。

说明

  • 列表适合运营后台、排查与批量核对场景。
  • 请求体主键名为 pageNum / pageSize,同时兼容 page / page_size 别名。
  • 本接口使用 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
pageNum
integer

页码,默认 1。

示例:

1

pageSize
integer

每页条数,默认 20,最大 100。

示例:

20

has_markup
boolean

按是否已配置 Markup 过滤。

示例:

true

status
enum<string>

状态过滤。

可用选项:
EFFECTIVE,
PENDING_EFFECTIVE
sub_merchant_id
string

精确筛选某一子账户。

示例:

"123456789"

page
integer

兼容别名:与 pageNum 等效。

示例:

1

page_size
integer

兼容别名:与 pageSize 等效。

示例:

20

响应

200 - application/json

成功响应。

status
enum<string>

接口处理状态。

可用选项:
SUCCESS,
FAIL
code
string

业务结果码。

示例:

"000000"

errorMessage
string

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

示例:

""

data
object