Skip to main content

Cryptocurrency Management

The Cryptocurrency Management feature is used to manage wallets and transaction records for cryptocurrencies such as USDT.

Feature Overview​

Main features include:

  • Transaction Records: Query USDT transaction records
  • Wallet Management: Manage merchant wallet addresses
  • System Wallet: Manage system-level hot wallets and cold wallets

Main Features​

Transaction Records (TxnRecord)​

Path: Cryptocurrency → TxnRecord

Query USDT (TRC20) transaction records.

Main Fields:

  • Transaction Hash (TxHash)
  • Transaction Type (Deposit / Withdrawal)
  • Amount
  • Sender Address
  • Receiver Address
  • Block Confirmations
  • Transaction Status
  • Transaction Time
  • Associated Order Number

Filter Function:

  • By time range
  • By transaction type
  • By address search
  • By transaction hash

Wallet List (WalletList)​

Path: Cryptocurrency → WalletList

Manage merchant USDT wallet addresses.

Features:

  • View all wallet addresses
  • View wallet balances
  • Generate new addresses
  • Export address list

Wallet Information:

  • Wallet Address
  • Owning Merchant
  • Current Balance
  • Whether Used
  • Creation Time
  • Last Transaction Time

System Wallet (SystemWallet)​

Path: Cryptocurrency → SystemWallet

Manage system-level wallet configurations.

Wallet Types:

Hot Wallet:

  • Used for daily deposits and payouts
  • Maintains an adequate balance
  • Automated operations

Cold Wallet:

  • Used for fund storage
  • High security
  • Manual operations

Configuration Items:

  • Wallet Address
  • Private Key Management
  • Balance Threshold Settings
  • Auto-transfer Rules

[!CAUTION] System wallet private keys must be safeguarded properly. Leakage will result in asset loss. It is recommended to use hardware wallets or multi-signature.

Transaction Flow​

USDT Deposit Flow​

  1. Merchant creates a deposit order
  2. System generates a dedicated address or uses a fixed amount
  3. User transfers USDT to the address
  4. System monitors on-chain transactions
  5. Order completes after deposit confirmation
  6. Callback notification sent to merchant

USDT Payout Flow​

  1. Merchant creates a payout order
  2. System validates order information
  3. On-chain transfer initiated from the hot wallet
  4. Wait for block confirmations
  5. Order completes after deposit confirmation
  6. Callback notification sent to merchant

Security Management​

Address Management​

  • Each order uses an independent address (dedicated address mode)
  • Addresses are bound to orders to avoid confusion
  • Unused addresses are periodically recycled

Balance Management​

  • Set hot wallet balance upper limit
  • Auto-transfer to cold wallet when exceeded
  • Alert when below threshold

Private Key Management​

  • Hot wallet private keys are encrypted for storage
  • Cold wallet private keys are stored offline
  • Hot wallets are periodically rotated

FAQ​

Q: How long does it take for USDT to arrive?​

A: Typically, the transaction is visible on-chain within 1-3 minutes, and the order completes after 19 block confirmations (approximately 60 seconds).

Q: How to handle incorrect transfers?​

A:

  1. Confirm whether the transaction reached the correct address
  2. Check if the amount matches
  3. If the address is incorrect, manual refund processing is required

Q: What to do when the hot wallet balance is insufficient?​

A:

  1. Transfer funds from the cold wallet to replenish
  2. Or temporarily disable the USDT payout service