Skip to main content
POST
Create Gift Card

Overview

This page documents the POST /v1/pay/gift/create endpoint. The full schema, parameters, and examples are rendered from the linked OpenAPI definition above.

Notes

Headers

X-GatePay-Certificate-ClientId
string
required

Merchant client ID

Example:

"mZ96D37oKk-HrWJc"

X-GatePay-Signature
string
required

Signature

Example:

"b8c4705ff4c1357f2a27925dd180c1e1f4a244148f312a2dee5afbcc6f4b150e9ffceee455c5a298f895d43a64ee829eebdfd262539d45c41f7aee4336fd8c8c"

X-GatePay-Timestamp
string
required

Millisecond timestamp; the difference from server time must not exceed 30 seconds.

Example:

"1738934053475"

X-GatePay-Nonce
string
required

Nonce

Example:

"5417061546"

Body

application/json

Create gift card request parameters

title
string
required

Gift card title

Example:

"api create gift card1"

templateId
string
required

Gift card template ID

Example:

"255267012439183360"

currency
string
required

Currency of gift card

Example:

"USDT"

amount
string
required

Amount of gift card

Example:

"0.99"

Response

200 - application/json

Created successfully

status
string

Response status

Example:

"SUCCESS"

code
string

Response code, 000000 indicates success

Example:

"000000"

errorMessage
string

Error message, empty on success

Example:

""

data
object