Skip to main content
POST
创建礼品卡

概述

本页说明 POST /v1/pay/gift/create 接口。完整的请求参数、响应结构与示例由上方关联的 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

创建礼品卡请求参数

title
string
required

礼品卡的标题

Example:

"创建礼品卡示例"

templateId
string
required

礼品卡封面的ID

Example:

"255267012439183360"

currency
string
required

礼品卡的币种

Example:

"USDT"

amount
string
required

礼品卡的金额

Example:

"0.99"

Response

200 - application/json

创建成功

status
string

响应状态

Example:

"SUCCESS"

code
string

响应码,000000表示成功

Example:

"000000"

errorMessage
string

错误信息,成功时为空

Example:

""

data
object