Virtual Currency Setup

Configure your game's virtual currencies through the INVO Network console at console.invo.network. Set up your default currency during game registration and manage additional currencies as your game grows.

Default Currency Setup

Configure your primary currency during game registration with name, symbol, and starting amounts.

Transfer Configuration

Set transfer rules including minimum/maximum amounts and transferability settings.

Symbol Image Upload

Upload custom currency symbols and icons with automatic Google Cloud Storage hosting.

Currency Management

Add, edit, and manage multiple currencies through the developer console interface.

Player Starting Balances

Configure how much currency new players receive when they first join your game.

Cross-Game Compatibility

Enable your currency for transfers across the entire INVO Network ecosystem.

Default Currency Setup

In Step 3 of the game registration wizard, you configure your primary currency that all new players will receive.

🪙 Currency Configuration Fields

Basic Information

  • • Currency Name: Display name for your currency (e.g., "Gold Coins")
  • • Currency Symbol: Short abbreviation (e.g., "GC", "GOLD")
  • • Currency Symbol URL: Optional image/icon for your currency
  • • Starting Amount: How much new players receive initially

Transfer Settings

  • • Transferable: Allow players to send/receive this currency
  • • Minimum Transfer: Smallest amount that can be transferred
  • • Maximum Transfer: Largest amount that can be transferred
  • • Currency Type: Automatically set to "default currency"
Default Currency JSON Structure
// Example default currency configuration from Step 3
{
  "currency_name": "Gold Coins",
  "currency_symbol": "GC", 
  "currency_symbol_url": "https://storage.googleapis.com/your-bucket/gold-coin.png",
  "currency_amount": 1000,
  "currency_type": "default currency",
  "transferable": true,
  "minimum_transfer_amount": 10,
  "maximum_transfer_amount": 50000
}

// This creates a currency where:
// - New players start with 1,000 Gold Coins
// - Players can transfer between 10-50,000 GC
// - Currency is transferable across INVO Network
// - Custom coin image hosted automatically

Currency Symbol Upload

Upload custom images for your currency symbols through the console interface. Images are automatically uploaded to Google Cloud Storage and optimized for display across the network.

📷 Image Requirements

  • • Format: PNG, JPG, or SVG
  • • Size: Recommended 64x64px or 128x128px
  • • Background: Transparent PNG preferred
  • • Max File Size: 2MB

☁️ Auto-Hosting

  • • Uploaded to Google Cloud Storage
  • • Globally distributed CDN
  • • Automatic optimization
  • • Permanent URL generation

Upload Process

1

Select Image File

Choose your currency symbol image from your computer

2

Automatic Upload

Console uploads to Google Cloud Storage and generates permanent URL

3

URL Auto-Population

The currency_symbol_url field is automatically filled with the hosted URL

Transfer Configuration

Configure how your currency can be transferred between players and across games in the INVO Network.

🔄 Transferable Currency

When Enabled:

  • • Players can send currency to other players
  • • Currency can move between different INVO games
  • • Enables cross-game ecosystem participation
  • • Subject to minimum/maximum transfer limits

When Disabled:

  • • Currency stays within your game only
  • • No player-to-player transfers
  • • Isolated economy system
  • • Can be enabled later if needed

💰 Transfer Limits

Minimum Transfer Amount:

  • • Prevents spam micro-transactions
  • • Reduces network transaction costs
  • • Typical range: 1-100 currency units
  • • Can be adjusted after game launch

Maximum Transfer Amount:

  • • Prevents large unauthorized transfers
  • • Reduces risk of account theft impact
  • • Typical range: 1,000-100,000 units
  • • Balance convenience vs security
Transfer Configuration Examples
// Transfer configuration examples

// Conservative Setup (Secure)
{
  "transferable": true,
  "minimum_transfer_amount": 50,
  "maximum_transfer_amount": 1000
}
// Good for: New games, high-value currencies, security-focused

// Moderate Setup (Balanced) 
{
  "transferable": true,
  "minimum_transfer_amount": 10,
  "maximum_transfer_amount": 10000
}
// Good for: Most games, balanced convenience and security

// Liberal Setup (Convenient)
{
  "transferable": true,
  "minimum_transfer_amount": 1,
  "maximum_transfer_amount": 100000
}
// Good for: Established games, low-value currencies, convenience-focused

// Isolated Setup (Game-Only)
{
  "transferable": false,
  "minimum_transfer_amount": 0,
  "maximum_transfer_amount": 0
}
// Good for: Competitive games, unique economies, no cross-game transfers

Currency Management Console

Access the currency management interface at console.invo.network to add, edit, and manage multiple currencies for your game.

Add Currency

Create new currencies beyond your default

Edit Settings

Modify transfer limits and properties

View Analytics

Monitor currency usage and transfers

Archive Currency

Safely remove unused currencies

Console Interface Features

Currency List View

  • • View all game currencies in one table
  • • Sort by name, type, or creation date
  • • Quick status indicators (active/inactive)
  • • Bulk actions for multiple currencies

Individual Currency Management

  • • Edit transfer limits in real-time
  • • Upload/change currency symbols
  • • View transfer history and analytics
  • • Configure player starting amounts

Multiple Currency Setup

Beyond your default currency, you can add premium currencies, seasonal currencies, or specialized tokens for different game mechanics.

💰 Premium Currency

  • • Purchased with real money
  • • Higher transfer limits
  • • Special game features access
  • • Example: "Premium Gems"

🎃 Seasonal Currency

  • • Limited-time availability
  • • Event-specific rewards
  • • Non-transferable often
  • • Example: "Halloween Tokens"

🏆 Achievement Currency

  • • Earned through gameplay
  • • Merit-based distribution
  • • Special store access
  • • Example: "Honor Points"
Multi-Currency Game Setup
// Multi-currency game configuration example
{
  "game_currencies": [
    {
      "currency_name": "Gold Coins",
      "currency_symbol": "GC",
      "currency_type": "default currency",
      "currency_amount": 1000,
      "transferable": true,
      "minimum_transfer_amount": 10,
      "maximum_transfer_amount": 50000
    },
    {
      "currency_name": "Premium Gems", 
      "currency_symbol": "PG",
      "currency_type": "premium currency",
      "currency_amount": 100,
      "transferable": true,
      "minimum_transfer_amount": 1,
      "maximum_transfer_amount": 10000
    },
    {
      "currency_name": "Event Tokens",
      "currency_symbol": "ET", 
      "currency_type": "seasonal currency",
      "currency_amount": 0,
      "transferable": false,
      "minimum_transfer_amount": 0,
      "maximum_transfer_amount": 0
    },
    {
      "currency_name": "Honor Points",
      "currency_symbol": "HP",
      "currency_type": "achievement currency", 
      "currency_amount": 0,
      "transferable": true,
      "minimum_transfer_amount": 5,
      "maximum_transfer_amount": 1000
    }
  ]
}

API Integration

Once configured in the console, your currencies are immediately available through the INVO Network APIs for player balance management and transactions.

Multi-Currency API Integration
// Accessing configured currencies via API
const SDK_KEY = 'ivsdk_your_64_character_key_here';

// Get player balances for all configured currencies
async function getPlayerCurrencies(playerEmail) {
  const response = await fetch(
    `https://invo.network/api/player-balances/player/by-email/${encodeURIComponent(playerEmail)}`,
    {
      headers: { 'X-Game-Secret-Key': SDK_KEY }
    }
  );
  
  const data = await response.json();
  
  // Response includes all configured currencies
  console.log('Player Currencies:');
  data.balances.forEach(balance => {
    console.log(`${balance.currency_name} (${balance.currency_symbol}): ${balance.total_balance}`);
  });
  
  return data;
}

// Example response with multiple currencies:
// {
//   "player": {
//     "player_id": 12345,
//     "player_name": "PlayerOne", 
//     "player_email": "player@example.com"
//   },
//   "balances": [
//     {
//       "currency_id": 1,
//       "currency_name": "Gold Coins",
//       "available_balance": "1500.00",
//       "reserved_balance": "50.00", 
//       "total_balance": "1550.00"
//     },
//     {
//       "currency_id": 2,
//       "currency_name": "Premium Gems",
//       "available_balance": "250.00",
//       "reserved_balance": "0.00",
//       "total_balance": "250.00"
//     },
//     {
//       "currency_id": 3,
//       "currency_name": "Event Tokens", 
//       "available_balance": "15.00",
//       "reserved_balance": "0.00",
//       "total_balance": "15.00"
//     }
//   ],
//   "summary": {
//     "total_value": "1815.00",
//     "currency_count": 3,
//     "has_funds": true
//   }
// }

Currency Design Best Practices

Follow these guidelines for optimal currency design and player experience:

💡 Design Guidelines

  • • Keep currency names simple and memorable
  • • Use 2-4 character symbols for clarity
  • • Start with generous amounts (1000+ base currency)
  • • Set transfer minimums to prevent spam
  • • Consider maximum transfers for security
  • • Upload recognizable symbol images

⚖️ Economic Balance

  • • Plan currency inflation and deflation
  • • Monitor cross-game transfer patterns
  • • Adjust transfer limits based on usage
  • • Consider multiple currency tiers
  • • Test currency economy before launch
  • • Have clear earning and spending sinks

Currency Setup Checklist

Complete these steps to successfully configure your game's virtual currencies:

🎯 Setup Tasks

  • • ✅ Complete Step 3 of game registration wizard
  • • ✅ Configure default currency name and symbol
  • • ✅ Set appropriate starting player amounts
  • • ✅ Upload currency symbol image (optional)
  • • ✅ Configure transfer settings and limits
  • • ✅ Test currency through player balance API

🔄 Post-Launch

  • • ✅ Monitor currency usage and transfers
  • • ✅ Add additional currencies as needed
  • • ✅ Adjust transfer limits based on data
  • • ✅ Update currency symbols and branding
  • • ✅ Manage seasonal/event currencies
  • • ✅ Optimize for cross-game participation