Skip to main content
POST
查询费用规则列表

概述

本页说明机构主商户分页检索子账户费用规则概览的接口。完整字段、请求体与响应示例由上方 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
必填

毫秒级时间戳,与服务端时间偏差不得超过30秒

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