Skip to content
TurnStay TurnStay Developer Docs

Quick Start

Get started with TurnStay Treasury in three steps: create a wallet, check available currencies, and initiate a deposit.

All Treasury amounts are in minor units (cents). For example, $1,000.00 USD = 100000. See Currencies & FX for details.

1. Check available currencies

Section titled “1. Check available currencies”
Terminal window
curl -X GET "https://treasury.staging.turnstay.com/api/v1/currencies" \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

This returns all supported currencies with their capabilities:

[
  {
    "code": "ZAR",
    "name": "South African Rand",
    "display_code": "ZAR",
    "currency_type": "fiat",
    "symbol": "R",
    "exponent": 2,
    "can_wallets": true,
    "can_payouts": true,
    "can_vban": false
  },
  {
    "code": "USD",
    "name": "US Dollar",
    "display_code": "USD",
    "currency_type": "fiat",
    "symbol": "$",
    "exponent": 2,
    "can_wallets": true,
    "can_payouts": true,
    "can_vban": true
  }
]

2. Create a wallet

Section titled “2. Create a wallet”
Terminal window
curl -X POST "https://treasury.staging.turnstay.com/api/v1/wallet" \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Operating Account",
    "currency_id": "USD"
  }'

3. Check your balance

Section titled “3. Check your balance”
Terminal window
curl -X GET "https://treasury.staging.turnstay.com/api/v1/wallet/{wallet_id}/balance" \
  -H "Authorization: Bearer sk_test_YOUR_KEY"
{
  "wallet_id": "wal_abc123",
  "balance": 0,
  "pending_holds": 0,
  "pending_in": 0,
  "pending_out": 0,
  "available_balance": 0,
  "currency_code": "USD"
}

Next steps

Section titled “Next steps”