Skip to main content
POST
Purchase a gift card

Authorizations

Authorization
string
header
required

Access token from POST /auth/v1/partner/token

Body

application/json
ext_id
string
required

Partner-side idempotency key (unique per partner)

Required string length: 1 - 128
Example:

"card-issue-20260710-003"

offer_id
string
required
value
string
Pattern: ^-?\d+(\.\d+)?$
Example:

"12.50"

required_fields
object

Response

Purchase accepted

ext_id
string

Partner-side idempotency key (unique per partner)

Required string length: 1 - 128
Example:

"card-issue-20260710-003"

purchase_id
string
offer_id
string
debit_amount
string
Pattern: ^-?\d+(\.\d+)?$
Example:

"12.50"

debit_currency
string
face_value
string
Pattern: ^-?\d+(\.\d+)?$
Example:

"12.50"

face_currency
string
status
string
created_at
string<date-time>
request_id
string<uuid>

Correlation id for support