Skip to main content
POST
Buy Gift Card

Authorizations

Authorization
string
header
required

Send your API key as Token <your_api_key>.

Use your live key for real transactions, or your sandbox key (sk_test_…) to test — sandbox calls return a realistic simulated result and never touch your wallet. Add "sandbox_status": "fail" to any sandbox request to simulate a failure.

Body

application/json
plan_id
integer
required

Variant ID from List Gift Cards

amount
number
required

Face value in the card currency

pin
string

4-digit transaction PIN (WEBSITE only, if enabled)

request-id
string

Unique idempotency key

Response

200 - application/json

Success

status
string
message
string
data
object