Skip to main content

Purchase gift card

POST 
/gift-card/purchase

Creates a gift card purchase order. Gift cards are fiat-denominated: no crypto asset or address is involved. The order starts in WAITING_FOR_DEPOSIT. Once the bank payment is confirmed, a gift card code is generated and emailed to recipient_email (or the buyer's email).

Purchases can be switched off: check GET /gift-card/settings first. Redeem the code later with POST /gift-card/redeem.

Request​

Body

required
    fiat_currency stringrequired

    Possible values: [EUR, CHF, USD]

    fiat_amount stringrequired

    Face value of the gift card

    email emailrequired
    recipient_email email

    Defaults to email

    origin string

    Possible values: [api, web, app]

    Default value: api

Responses​

Order created

Schema
    order object
    id string

    Short public token (shown to customer)

    code string

    Human-readable order reference. Quote it when contacting support.

    email string
    direction string

    Possible values: [onramp, offramp]

    asset stringnullable

    Null for gift card purchases — no crypto asset involved

    fiat_currency string
    fiat_amount stringnullable

    Null until settlement for off-ramp orders — see status

    crypto_amount stringnullable

    Null until settlement for on-ramp orders — see status

    status string

    Possible values: [WAITING_FOR_DEPOSIT, DEPOSIT_RECEIVED, PROCESSING, COMPLETED, FAILED, PENDING_MANUAL, REJECTED, EXPIRED, REFUNDED]

    transfer_code string

    Bank payment reference the customer must include in their transfer

    destination_type string

    Possible values: [crypto, sepa, swift, us, gift_card]

    destination_crypto_address stringnullable
    deposit_txid stringnullable

    Off-ramp: the Arkade transaction credited as the deposit

    deposit_iban stringnullable
    deposit_bic stringnullable
    deposit_beneficiary stringnullable
    deposit_bank_name stringnullable
    deposit_payment_type stringnullable
    kyc_verified boolean
    created_at date-time
    expires_at date-timenullable
    completed_at date-timenullable
    bank_details object

    Bank details the customer must pay into

    iban string
    bic string
    beneficiary string
    bank_name string
    payment_type string
    transfer_code string
    fee object
    feePct string
    feeFlat string
    feeAmount string
    netAmount string
Loading...