Wallets
A SentBiz multi-currency wallet is a currency-holding account linked to a specific Channel. It supports multiple currencies and acts as the core ledger for receiving (via virtual accounts), converting (FX), and disbursing (payouts) funds.

Wallet Structure
Channel: Logical grouping defined by purpose (e.g., region, brand, business use)
Wallet: One per channel; manages all funds collected through that channel
Currency: Each wallet supports balances by currency
Virtual Account (VA): KRW-based deposit account issued to merchants. Incoming funds are automatically posted to the corresponding channel's wallet.
Fund Flow
- Deposit is made into a merchant's Virtual Account (VA)
- The KRW amount is posted to the wallet linked to the merchant's channel
- KRW balance increases in the wallet
- Optional FX: Convert KRW into foreign currency within the wallet
- Initiate payout using the converted funds (via Payout API)
FX Capabilities
Currency conversions within a wallet can be performed through the following options:
- Real-Time FX Conversions
- Instantly converts available balances using market rates at the time of the request (available 24/7)
- Suitable for fast treasury operations or urgent payout needs
- Locked Rate FX Conversions
- Locks in an exchange rate for a defined period, with manual approval by the SentBiz operations team before execution
- Useful for managing FX risk and securing rate certainty
- This option is available only to select clients based on individual agreements
- Transaction-Level FX
- Automatically applies real-time FX at the moment of each payout request
- Streamlines treasury operations and ensures efficient rate application
API Summary
Method | API Endpoint | Description |
---|---|---|
POST | /v2/wallets/{wallet_id}/convert | Initiate a wallet currency transfer based on a provided quote |
GET | /v2/wallets | Retrieve the list of wallets under the same channel |
GET | /v2/wallets/{wallet_id} | Get wallet balances by currency |
POST | /v2/wallets/{wallet_id}/transactions/search | Search wallet transactions using filters |
GET | /v2/wallets/{wallet_id}/transactions/{transaction_id} | Get detailed information of a specific transaction |
Updated 23 days ago