Skip to main content
POST
查询礼品卡

概述

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

说明

Headers

X-GatePay-Certificate-ClientId
string
required

商户客户端ID

Example:

"mZ96D37oKk-HrWJc"

X-GatePay-Signature
string
required

签名

Example:

"b8c4705ff4c1357f2a27925dd180c1e1f4a244148f312a2dee5afbcc6f4b150e9ffceee455c5a298f895d43a64ee829eebdfd262539d45c41f7aee4336fd8c8c"

X-GatePay-Timestamp
string
required

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

Example:

"1738934053475"

X-GatePay-Nonce
string
required

随机数

Example:

"5417061546"

Body

application/json

查询礼品卡请求参数(card_number 和 key 二选一)

card_number
string

礼品卡卡号(与 key 二选一)

Example:

"5202710871862281"

key
string

兑换码(与 card_number 二选一,两个都传时优先使用 key)

Example:

""

Response

200 - application/json

查询成功

status
string

响应状态

Example:

"SUCCESS"

code
string

响应码

Example:

"000000"

errorMessage
string

错误信息

Example:

""

data
object