Sign in
latestOpenAPI 3.1.02026-08-214257272.8 KB

6c351c1bd0eb

Wallet

Get top-up configuration

Fees and limits for wallet top-ups, plus the workspace's applied promotion (tiers, presets) and the auto-reload checkout offer.

get/v1/wallet/topup

Response

Top-up fees, limits, promotion tiers, and presets

minAmountnumber required

Minimum top-up amount in dollars.

maxAmountnumber

Maximum top-up amount in dollars. Omitted when no app-level cap is configured.

currency'USD' required

Top-up currency (currently always USD).

presetsnumber[] required

Preset amounts in dollars, display order. Bonuses are client-derived from tiers (round-down tier match).

defaultPresetnumber required

Pre-selected preset amount in dollars.

Example response

{
  "minAmount": 5,
  "maxAmount": 1000,
  "processingFee": {
    "rate": 0.05,
    "description": "Processing fee (5%)"
  },
  "promotion": {
    "key": "firstTopup",
    "label": "New user promotion"
  },
  "tiers": [
    {
      "minAmount": 100,
      "rate": 0.15
    }
  ],
  "defaultPreset": 100,
  "autoReload": {
    "refillAmount": 15,
    "threshold": 5
  }
}