Gift cards

Scopes: gift:read, gift:purchase, or gift:*. Catalog availability is controlled per tenant. Disabled catalog → empty offers / 503 / catalog_disabled. An emergency kill-switch may return 503 / gift_disabled. This GET is live availability and the live USDT quote (price_usdt). There is no POST /quote and no separate availability API. Cache briefly; respect catalog rate limits.

List offers

GET https://api.imbawallet.com/partner/gift-offers?brand=Roblox&country=US&limit=50
Authorization: Bearer <access_token>

Common query filters: brand, country, limit (max 50), cursor. Offers may be FIXED (no value on purchase) or RANGE (min_value / max_value / value_currency — you must pass value on purchase).

Purchase

POST https://api.imbawallet.com/partner/gift-cards
Authorization: Bearer <access_token>
Content-Type: application/json

{
  "ext_id": "gift-20260710-001",
  "offer_id": "gift-roblox-10-usd",
  "required_fields": {},
  "value": null
}

Field	Notes
`ext_id`	Required, idempotent
`offer_id`	From catalog
`value`	Required for RANGE offers (face value in offer currency); omit/ignore for FIXED
`required_fields`	Brand-specific fields when the catalog requires them (e.g. email)
`quantity`	Optional, 1..20 — N purchases (`ext_id`, `ext_id#2`, …); response has `items[]`

Response `202`

{
  "ext_id": "gift-20260710-001",
  "purchase_id": "019d0150-cccc-7ddd-8eee-333344445555",
  "offer_id": "gift-roblox-10-usd",
  "debit_amount": "9.80",
  "debit_currency": "USDT",
  "face_value": "10.00",
  "face_currency": "USD",
  "status": "pending",
  "created_at": "2026-07-10T11:00:00.000Z"
}

Webhook gift_purchase.status_changed — without code/epin.
Fetch the receipt via GET. Errors: catalog_disabled, unknown_offer / offer_unavailable, missing_required_field, invalid_value, catalog_stale, insufficient_balance, gift_disabled, ext_id_conflict.

Get purchase / receipt

GET https://api.imbawallet.com/partner/gift-cards/{purchase_id}
Authorization: Bearer <access_token>

After completed:

{
  "purchase_id": "019d0150-cccc-7ddd-8eee-333344445555",
  "ext_id": "gift-20260710-001",
  "offer_id": "gift-roblox-10-usd",
  "status": "completed",
  "face_value": "10.00",
  "face_currency": "USD",
  "receipt": {
    "epin": "XXXX-YYYY-ZZZZ",
    "voucher_id": null,
    "redemption_url": null,
    "expires_at": null,
    "instructions": null
  },
  "created_at": "2026-07-10T11:00:00.000Z",
  "completed_at": "2026-07-10T11:00:45.000Z"
}

The redemption secret field is epin (not a generic code). Do not log plaintext receipts. IMBA does not send the code to your end user. After completed, pull this GET and deliver in your UI (no white-label fulfillment by IMBA). Typical time to completed is seconds to a few minutes — not a hard SLA. Refunds: none for a working / unused voucher. Provider failure before delivery returns the reserve. There is no cancel-purchase endpoint.

Get started

Money

Products

Operations

List offers

Purchase

Response `202`

Get purchase / receipt

​List offers

​Purchase

​Response 202

​Get purchase / receipt

List offers

Purchase

Response `202`

Get purchase / receipt