Skip to main content
POST
批量查询礼品卡

概述

本页说明 POST /v1/pay/gift/batch/query 接口。完整的请求参数、响应结构与示例由上方关联的 OpenAPI 定义渲染。

说明

请求头

X-GatePay-Certificate-ClientId
string
必填

商户客户端ID

示例:

"mZ96D37oKk-HrWJc"

X-GatePay-Signature
string
必填

签名

示例:

"b8c4705ff4c1357f2a27925dd180c1e1f4a244148f312a2dee5afbcc6f4b150e9ffceee455c5a298f895d43a64ee829eebdfd262539d45c41f7aee4336fd8c8c"

X-GatePay-Timestamp
string
必填

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

示例:

"1738934053475"

X-GatePay-Nonce
string
必填

随机数

示例:

"5417061546"

请求体

application/json

批量查询请求参数。batch_id 或完整的 start_time/end_time 时间范围至少传一个。

batch_id 或完整的 start_time/end_time 时间范围至少传一个。

batch_id
string
必填

礼品卡批次号。传入后按批次精确过滤;与时间范围同时传入时取交集。

Required string length: 1 - 64
示例:

"G545273793309741056"

start_time
integer<int64>

创建时间范围起点,毫秒级 Unix 时间戳,闭区间。必须与 end_time 成对传入。

必填范围: x >= 0
示例:

1791916618083

end_time
integer<int64>

创建时间范围终点,毫秒级 Unix 时间戳,闭区间。单次查询跨度不得超过 31 天。

必填范围: x >= 0
示例:

1791939618083

page
integer
默认值:1

页码,从 1 开始。

必填范围: x >= 1
示例:

1

page_size
integer
默认值:20

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

必填范围: 1 <= x <= 100
示例:

20

响应

200 - application/json

查询成功

status
string

响应状态

示例:

"SUCCESS"

code
string

响应码,000000 表示成功

示例:

"000000"

errorMessage
string

错误信息,成功时为空

示例:

""

data
object