Virtual Currency Setup

Every title has one currency, set up when you register the title in the console at console.invo.network and edited from the title's settings afterwards. You choose its name, symbol and transfer limits; its value against the dollar is the network rate below.

The fields

Field	What it does
`currency_name`	The name players see, for example "Gold Coins".
`currency_symbol`	A short symbol, up to 10 characters, for example "GC".
`currency_symbol_url`	An image for the currency, uploaded from the console (below).
`currency_type`	A label: `premium`, `basic`, `special` or `default currency`. You can change it when you edit the currency. It does not change how the currency behaves.
`transferable`	Whether players can move this currency to other titles with a cross-game transfer.
`minimum_transfer_amount`, `maximum_transfer_amount`	The smallest and largest amount one transfer or send out of your title may carry, in units. No maximum means no per-transfer cap from your title (network limits still apply).
`currency_amount`	A legacy display field. It is not granted to new players and nothing that moves money reads it. A new player starts at a balance of 0 until they buy or receive currency.

A currency as the console sends it

{
  "currency_name": "Gold Coins",
  "currency_symbol": "GC",
  "currency_symbol_url": "https://<your hosted image URL>",
  "currency_type": "premium",
  "transferable": true,
  "minimum_transfer_amount": 10,
  "maximum_transfer_amount": 50000
}

There is one currency per title: you edit it, you do not add a second one, and there is no archive or delete. A product with several economies registers each as its own title.

The symbol image

Upload the image from the currency settings in the console; the console hosts it and fills in currency_symbol_url. A small square image with a transparent background works best (for example a PNG of 256 by 256 pixels). The console states the formats and size it accepts.

Transfer limits

• Minimum and maximum apply to each transfer or send out of your title, checked against your currency when it starts.
• Network limits apply as well, per player per day and per hour, whatever your own limits are. See Cross-Game Transfers and Initiate Player Send.
• Destinations also depend on your title's transfer policy and on the other title being Live. See Available Destinations.

Currency value and the network rate

Every currency is valued at the network rate, 1 USD = 10 units, unless INVO has set a different rate for it. A different rate can only be set before the currency has any balance, transaction, order or subscription; once it is in use its rate does not change. Ask INVO at partners@invo.network before launch if you need one.

You set your item prices in units: a 500-unit item at the network rate is $50.

Players move value between titles in units, and a transfer between two titles converts at each title's rate when the two differ, so 100 units at the network rate are worth the same in every title that uses it. Read the amounts on the transfer responses and webhooks rather than computing them.