Redeem gift card
POST/gift-card/redeem/
Redeem a gift card for cryptocurrency.
The gift card code must be in UUID format. Only the secret code (not the identification_code) can be used for redemption.
Request
- application/json
Body
code_str stringrequired
The gift card secret code (UUID format)
email emailrequired
The email of the user redeeming the gift card
to_asset stringrequired
The cryptocurrency to receive (cannot be fiat currency)
destination_crypto_address stringrequired
The crypto address to send the funds to
origin string
Possible values: [web
]
Default value: web
The origin of the request (web only supported)
Responses
- 201
The order representing the redeemed gift card.
- application/json
- Schema
- Example (from schema)
- Example
Schema
id string
email email
from_asset string
to_asset string
from_amount float
status string
Possible values: [WAITING_FOR_DEPOSIT
, DEPOSIT_RECEIVED
, DEPOSIT_CONFIRMED
, APPROVED
, COMPLETED
, CANCELED
, EXPIRED
, REJECTED
, REFUNDED
]
created_at string
funding_type string
origin string
destination_type string
Possible values: [crypto
]
destination_crypto_address string
{
"id": "string",
"email": "user@example.com",
"from_asset": "string",
"to_asset": "string",
"from_amount": 0,
"status": "WAITING_FOR_DEPOSIT",
"created_at": "string",
"funding_type": "default",
"origin": "web",
"destination_type": "crypto",
"destination_crypto_address": "string"
}
{
"id": "nljyy9ezbvlahbj4ixtsd3k5s9g4g1up",
"email": "customer@example.com",
"from_asset": "USD",
"to_asset": "BTC",
"from_amount": 100.0,
"status": "WAITING_FOR_DEPOSIT",
"created_at": "2025-04-23 23:56:53",
"funding_type": "default",
"origin": "web",
"destination_type": "crypto",
"destination_crypto_address": "bc1qxy2kgdygjrsqtzq2n0yrf2493p83kkfjhx0wlh"
}
Loading...