A terminal is one permanent set of deposit addresses, identified by a number called nounce in requests and terminalId in callbacks and inquiries.
A VIP account gets a range of 100,000 terminals, shown in Gateway Setting (Terminal (Nonce) Start / End, e.g. 300000–399999). Numbers outside it are rejected (TerminalId is not valid.).
Give one terminal to each of your users and store it with the user. The addresses never change, and they stay watched forever, so a terminal must never be given to another user.
A terminal has one EVM address, the same on every EVM network we support (BSC, Ethereum, Polygon, Arbitrum, Optimism, Avax, Sonic), and one Tron address.
Every supported token sent to it is credited, whatever token you asked for in Request Wallet.
Calling Request Wallet again for a terminal is safe: same addresses, and it replaces the terminal's callback_url and description.
Ramzlink invoices use temporary terminals of their own; you only see them as terminalId in Get Deposits.
trxRefId (callbacks, Inquiry) and trx_hash (lists, invoices) are the blockchain transaction hash of the deposit: 0x… (66 characters) on EVM networks, 64 hex characters without 0x on Tron. You can look it up in any block explorer.One credit per transaction: if a single transaction sends tokens to several of your addresses (some batch payouts do), only the first transfer is credited automatically. Contact support with the hash for the others.
Tokens List is the source of truth: for each token, the networks where it can be deposited (allow_deposit) and withdrawn (allow_withdraw), and the fees. A network's name (BSC, Tron, Ethereum, …) is the value used in deposits (network, chainName) and in withdrawals (chain).The addresses list from Request Wallet already contains only the networks where that token can be deposited. Show your users that list, not a fixed one.
Deposit fee: a percentage of each deposit (your account's rate), with a minimum and a maximum per token and network. The minimum is min_deposit_fee in Tokens List and minDeposit next to each address. A deposit of the minimum or less is taken completely as fee and credits 0. Tell your users to send more than minDeposit.
Withdrawal fee: a fixed amount per token and network, withdraw_fee in Tokens List.
Each deposit's fee is in Inquiry and Get Deposits; each withdrawal's in Get single Withdrawal.
A deposit is credited once its transaction is in a block and our tracker has read that block, usually within a few minutes. The callback is sent right after that. Withdrawals are paid on chain in regular batches, usually within minutes.