Title Registration

Register your title with the INVO Network platform through our comprehensive 4-step registration wizard. Get your auto-generated SDK key, configure your currency, and start integrating immediately.

Assets & Info

Upload your icon and cover image, and configure basic title information and transfer policies.

Auto-Generated SDK Key

Receive your unique SDK key automatically generated in step 2: ivsdk_live_[random] in production, ivsdk_test_[random] in test mode.

Default Currency Setup

Configure your primary currency with symbol, transfer limits, and exchange rules.

Payout Integration

Optional secure bank integration for automated revenue payouts and financial management.

Immediate API Access

Your SDK key works as soon as the wizard completes, so you can start integrating straight away.

Testing First, Live When Ready

A new title starts in Testing. Set it to Live yourself from the console when you are ready; no INVO review is needed.

4-Step Registration Wizard

Complete your setup through our streamlined wizard at console.invo.network:

1

Game Information & Assets

Upload assets and configure your title's basic information and transfer settings.

Required Assets:

  • • Game icon (square format)
  • • Cover image (1920x1080px)

Game Details:

  • • Game name & developer
  • • Genre(s) & platform(s)
  • • Transfer policy (Universal/Manual)
2

SDK Key Generation

Your unique API key is automatically generated for immediate use.

Format: ivsdk_live_ (production) or ivsdk_test_ (test mode) followed by a random string. The console generates it when you register, emails it to you, and keeps it readable on Platform & Keys, labelled test or live; a key INVO generates on rotation carries the same prefix for its environment. Keys issued before the prefix was added start ivsdk_ with no environment and keep working. Treat the length as opaque.

Supplying your own key: sdkKey is optional when you create a game. If you omit it, INVO generates the key and returns it in game.secret_key. If you supply one, it must be ivsdk_ followed by at least 32 characters from letters, digits, - and _; otherwise the call returns 400 WEAK_SDK_KEY. A key you supply may not start with ivsdk_live_, ivsdk_test_, ivsdk_demo_ or ivsdk_arcade_ in any letter case; those are reserved and return 400 RESERVED_SDK_KEY_PREFIX. Leave sdkKey out and INVO mints a key that starts ivsdk_live_ in production or ivsdk_test_ in test mode.

Usage: Include in X-Game-Secret-Key: {SDK_KEY} header on every API request

Security: Server-side only, never expose in client code

3

Default Currency Setup

Configure your title's primary currency with transfer rules and limits.

Currency Config:

  • • Currency name & symbol
  • • Symbol image URL (optional)
  • • Starting player amount

Transfer Rules:

  • • Transferable (yes/no)
  • • Minimum transfer amount
  • • Maximum transfer amount
4

Payout Setup (Optional)

Connect your bank account through our verified bank-linking partner for automated revenue payouts.

Bank Integration: Secure verified bank connection for ACH transfers

Revenue Sources: Transfer fees (3.5%) + Item sales profit (95%)

Alternative: Manual check payments if bank linking is unavailable

Game Configuration Example

Here's an example of the data structure created during your registration:

Complete Game Registration Data
// Step 1: Game Information
{
  "gameName": "Epic Adventure RPG",
  "tenantType": "game", // game | video_platform | creator_platform | social_platform (default: game)
  "developerName": "Your Studio Name",
  "publisherName": "Your Publisher",
  "gameDescription": "A fantasy RPG with cross-platform progression",
  "genre": ["RPG", "Adventure"],
  "platform": ["PC", "Mobile", "Console"],
  "gameUrl": "https://epicadventure.game",
  "gameIconUrl": "https://storage.googleapis.com/your-bucket/game-icon.png",
  "coverImageUrl": "https://storage.googleapis.com/your-bucket/cover.jpg",
  "universalTransfers": "yes", // or "no" for manual linking
  "linkedGameIds": [], // populated if universalTransfers = "no"
  "paymentRail": "game" // platform | game | steam: see "Payment route" below (default: platform)
}

// Step 2: SDK Key (optional; omit it and INVO generates one, returned in game.secret_key)
{
  "sdkKey": "ivsdk_<at least 32 letters, digits, - or _>"
}

// Step 3: Default Currency
{
  "defaultCurrency": {
    "currency_name": "Gold Coins",
    "currency_symbol": "GC",
    "currency_symbol_url": "https://storage.googleapis.com/your-bucket/coin.png",
    "currency_amount": 1000, // Starting amount for new players
    "currency_type": "default currency",
    "transferable": true,
    "minimum_transfer_amount": 10,
    "maximum_transfer_amount": 50000
  }
}

// Step 4: Payout Configuration (Optional)
{
  "payoutMethod": "bank", // or "mail"
  "bankDetails": {
    "accountHolderName": "Your Studio Name",
    "bankName": "Chase Bank",
    "routingNumber": "021000021",
    "accountNumber": "1234567890", // Only last 4 digits stored
    "accountType": "business_checking"
  }
}

Game or platform

Set tenantType to say what you are registering: game (the default), or a platform (video_platform, creator_platform or social_platform). Any other value is refused with 400 INVALID_TENANT_TYPE. No identity verification is needed for either; it is asked for only before a withdrawal.

  • Currency moves between games and platforms in both directions, subject to each title's transfer settings.
  • A platform buys currency through the platform payment route only. Registering a platform with a game-only route is refused with 400 RAIL_NOT_AVAILABLE_TO_PLATFORM.
  • You can switch between game and platform yourself until the title's first live transaction. After that, the switch returns 409 TENANT_TYPE_LOCKED_AFTER_LIVE_TRANSACTION and INVO makes the change after review. See Platform Partners.

The registration response echoes the recorded value as tenantType.

Payment route

Set paymentRail at registration so your purchases route correctly. You pick by where your product lives. INVO processes every payment and pays you out, so there is no payment processor for you to set up:

  • platform: a platform or non-game app (web/mobile storefront, creator platform). Default.
  • game: a game distributed anywhere except Steam (mobile, standalone, web, console store).
  • steam: a game distributed on Steam (players pay with their Steam Wallet).

Set it once here and every purchase for this title routes automatically. There is no need to pass a rail on each call. You can change it later if your distribution changes. See Payment Methods for the full guide.

Every account starts on the Open tier: on card sales your business is the seller and is responsible for any sales tax, VAT or GST, and on card purchases of coins the player pays the listed price while you pay the card fee (3.5% + $0.15, charged against your earnings). INVO can approve an account for the Merchant of Record tier, where INVO is the seller and handles consumption tax. See Tiers.

Immediate API Access

Your SDK key is active immediately after wizard completion. Start integrating right away:

Production Environment

Base URL:invo.network/api
SDK Key:ivsdk_live_your_key...
Status:Testing (default); set Live from the console

First API Call

Test API Access
// Test your SDK key immediately
const response = await fetch(
  'https://invo.network/api/player-balances/player/by-email/test@example.com',
  { headers: { 'X-Game-Secret-Key': YOUR_SDK_KEY } }
);

// 404 here is expected if the player doesn't exist yet: players auto-create
// the first time they hit a writing endpoint (purchase-currency, purchase-item).
console.log(response.status, await response.json());

Status Options

During registration, you can set your title's initial status:

🔧 Testing Status

  • • Default status for new titles
  • • Full API access for your own calls
  • • Cannot receive cross-game transfers or player sends from other titles, and cannot sell subscriptions
  • • Set it to Live yourself from the console at any time

🚀 Live Status

  • • For launched titles
  • • Can be a transfer and send destination and sell subscriptions
  • • Real money transactions enabled
  • • Revenue sharing active

Prerequisites

Before registering your title, ensure you have:

  • • Completed developer account registration at console.invo.network
  • • Assets ready (square icon, 1920x1080 cover image)
  • • Decided on currency name, symbol, and transfer policy
  • • Bank account information if enabling payouts
  • • Server-side integration capability (SDK keys are server-only)
  • • Understanding of your title's monetization and currency flow

Transfer Policy Options

In Step 1, choose how your title participates in cross-game transfers:

🌍 Universal Transfers

  • • Accept transfers from any INVO title
  • • Send transfers to any INVO title
  • • Maximum network reach
  • • Recommended for most titles

🎯 Manual Linking

  • • Only transfer with specific titles
  • • Choose your partner titles
  • • More controlled ecosystem
  • • Good for series and franchises

Post-Registration Benefits

After completing the 4-step wizard, you immediately gain:

  • • Instant SDK Key: Ready-to-use API authentication
  • • Full API Access: Player balances, transfers, purchases, item sales
  • • Developer Dashboard: Analytics, revenue tracking, title management
  • • Email Confirmation: SDK key sent to your email with integration instructions
  • • Currency Operations: Accept purchases, track balances, process transfers
  • • Revenue Sharing: Earn from transfer fees (3.5%) and item sales (95%)
  • • Network Access: Connect with thousands of registered INVO titles