Skip to main content

Top-Up Your CrossFi App Balance

Fund your CrossFi Card by transferring XFI tokens from your external wallet to your CrossFi App balance. The Top-Up feature enables seamless token transfers that can be used for purchases and transactions with your CrossFi card.

💳 Instant Availability

Topped-up funds are immediately available for CrossFi Card transactions and in-app purchases.

🔒 Full Control

Your funds remain under your control - withdraw (unhold) them back to your wallet at any time.

🌐 Multi-Wallet Support

Compatible with MetaMask, OKX Wallet, SafePal, imToken, Gems, and other Web3 wallets.

Prerequisites​

Before you begin the top-up process, ensure you have:

  • EVM-compatible wallet (MetaMask recommended)
  • XFI tokens on CrossFi network for the top-up amount
  • Additional XFI for gas fees - ensure you have extra XFI beyond your top-up amount to cover transaction fees
Don't Have XFI Tokens?

If you don't have XFI tokens yet, check out our comprehensive guide on How to get XFI You can also use the built-in Swap feature in CrossFi App to exchange tokens from other networks directly within the app. CrossFi App Swap Guide

Supported Wallets​

CrossFi App supports multiple Web3 wallets including:

  • MetaMask (recommended)
  • OKX Wallet
  • SafePal
  • imToken
  • Gems

All wallets support the same top-up functionality and security features. We recommend MetaMask for optimal experience due to its excellent security features and easy CrossFi network configuration.

XFI Console Migration​

Already Have XFI in XFI Console?

If you have XFI tokens in XFI Console, you can import your seed phrase into MetaMask to access your tokens.

Learn more: Complete XFI Console to CrossFi App Migration Guide

Step-by-Step Top-Up Guide​

📱 Interactive Demo: How to Top-Up CrossFi App Balance

Step 1: Connect Your Wallet​

Important Wallet Limitations
  • Funds topped up from a specific wallet can only be withdrawn (unhold) back to that same wallet address
  • You can only use one wallet for top-ups - to switch wallets, you must first unhold all funds to the wallet from which they were originally held
  1. Open CrossFi App and tap the "Top up" button on the main screen
  2. Select "Connect Wallet"
  3. Choose your preferred wallet from the available options (MetaMask recommended)
  4. Confirm the connection in your wallet when prompted
  5. Return to CrossFi App - your wallet address should now be displayed
Connect wallet and return to CrossFi App with wallet address displayed

Step 2: Authorize Message Signing​

This one-time security step allows CrossFi App to securely interact with your wallet.

  1. Tap "Sign on" in the CrossFi App
  2. Your wallet will open automatically
  3. Review the authorization message
  4. Click "Confirm" to sign the message
  5. Return to CrossFi App to continue
Security Note

This message signing doesn't give access to your funds - it only authorizes the app to initiate transactions that you must approve.

Authorize message signing in wallet

Step 3: Enter Top-Up Amount​

  1. Enter the amount of XFI tokens you want to transfer to your CrossFi App balance
  2. Review the amount and tap "Top Up"
  3. Your wallet will open for transaction confirmation
  4. Review transaction details including gas fees
  5. Click "Confirm" if everything is correct
Gas Fees Required

Ensure you have additional XFI tokens in your wallet beyond the top-up amount to cover network gas fees. The transaction will fail if you don't have sufficient XFI for gas fees.

Enter top-up amount and confirm transaction

Step 4: Balance Update​

  1. Wait for transaction processing (usually under 30 seconds)
  2. Your CrossFi App balance will update automatically
Success!

Your funds are now available for CrossFi Card transactions!

Successful top-up with updated CrossFi App balance

💱 Token Swap​

Exchange tokens from other networks for XFI directly within the app before topping up.

Learn about Swap

Need Help?​

▶Which wallets does CrossFi App support?
▶Can I connect multiple wallets?
▶How much XFI do I need?

For complete FAQ including account management, cards, KYC verification and more: CrossFi App Complete FAQ

Ready to get started? Download CrossFi App and begin your seamless Web3 payment experience today.