跳转到主要内容
GET
/
rate
/
commission_rule
查询费用配置规则详情
curl --request GET \
  --url https://openplatform.gateapi.io/rate/commission_rule \
  --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>'
{
  "status": "SUCCESS",
  "code": "000000",
  "errorMessage": "",
  "data": {
    "sub_merchant_id": "123456789",
    "has_markup": true,
    "config_id": "cfg_202604150001",
    "r_markup": 0.001,
    "f_markup": 0,
    "status": "EFFECTIVE",
    "effective_date": "2026-04-15 00:00:00",
    "expired_date": null,
    "actual_rate": {
      "r_total": 0.0035,
      "f_total": 1
    },
    "updated_at": "2026-04-15T08:30: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
  • 通用签名规则请参见 /api-reference/version/100/cn/common/securityAndSignature

请求头

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。该接口组通过此请求头声明当前机构主商户上下文。

查询参数

sub_merchant_id
string
必填

子账户 ID。

effective_date
string

查询时间,格式 YYYY-MM-DD HH:mm:ss;不传则返回当前时间的生效配置。

响应

200 - application/json

成功响应。

status
enum<string>

接口处理状态。

可用选项:
SUCCESS,
FAIL
code
string

业务结果码。

示例:

"000000"

errorMessage
string

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

示例:

""

data
object