Overview

TurnStay Treasury provides multi-currency wallet infrastructure for managing funds — deposits, withdrawals, transfers, and virtual accounts.

Key concepts

Concept	Description
Wallet	A currency-denominated account that holds funds. Each wallet has a single currency.
Deposit	Fund a wallet via bank transfer or stablecoin deposit.
Withdrawal	Send funds from a wallet to an external bank account.
Transfer	Move funds between wallets, including cross-currency transfers with automatic FX.
Virtual Account	A dedicated bank account number (IBAN/VBAN) linked to a wallet for receiving deposits.
Beneficiary	A saved recipient for payouts — includes bank details.

API base

Treasury runs as a separate service with its own base URL:

Environment	Base URL
Staging	https://treasury.staging.turnstay.com
Production	https://treasury.turnstay.com

Authentication uses the same Bearer token and API key as Payments. See Authentication and Environments for the full URL reference.

Treasury endpoints

Resource	Endpoints
Wallets	POST /api/v1/wallet, GET /api/v1/wallet/{id}, GET /api/v1/wallets, GET /api/v1/wallet/{id}/balance, GET /api/v1/wallets/balances
Deposits	POST /api/v1/deposit, GET /api/v1/deposit/{id}
Withdrawals	POST /api/v1/withdraw, GET /api/v1/withdraw/{id}, GET /api/v1/withdrawals
Transfers	POST /api/v1/transfer, GET /api/v1/transfer/{id}, GET /api/v1/transfers
Virtual Accounts	POST /api/v1/virtual-account, GET /api/v1/virtual-accounts
Bank Accounts	POST /api/v1/bank-account, GET /api/v1/bank-account/formats, GET /api/v1/bank-account/bank-names
Beneficiaries	POST /api/v1/beneficiary, GET /api/v1/beneficiary/{id}, GET /api/v1/beneficiaries
Currencies	GET /api/v1/currencies