Currencies

Where can I see the list of currencies?

Log into the hizi app to see the default list of supported currencies, in the side panel. We use the ISO-4217 code for currencies. The side panel also shows the default multiplier for these currencies. Use this list to check if a currency is supported by default. You can also share this currency list with partners.

What are multipliers?

The multiplier is a user-friendly value that the player sees. EUR is our base currency for calculation. For example, if 1 EUR equals 4.7 PLN, the system uses a multiplier of "5" for PLN. Multipliers do not affect actual currency exchange rates. They only improve the player experience.

Can I change the multiplier from the default one?

Yes. Change it under the custom currency multipliers section. Multipliers cannot be less than "1".

The currency is not on the list. Can I add custom currencies?

Yes. Add custom currencies per Identity, in the "Settings" section. If an Identity tries to load a game with a currency that you have not added, the system returns an error message.

Will I see any custom currencies I add in the main currency list?

No. You can view them in the Identities where you created them.

If a Partner asks for "Bitcoin" or "Ethereum" support, what do we tell them?

Tell the Partner the exact code used for this cryptocurrency, along with any logic for that code, including the multipliers. See below for a full explanation.

How does it work with cryptocurrencies?

Cryptocurrencies use the same mechanism as fiat currencies. Our existing crypto codes, like METH ("milli-ETH", one thousandth of an ether) and UBTC ("micro-BTC", one millionth of a bitcoin), are virtual currencies. Each is a small, whole-number-friendly unit of a real cryptocurrency. Each has its own multiplier, just like a fiat currency.

All wallet amounts, in any currency, are integers equal to 1/100 of a currency unit (like cents). This rule does not change for a cryptocurrency.

The constraint that decides your currency code: the multiplier must be a whole number, 1 or higher. The multiplier tells the system how many units of the new currency equal about 1 EUR. The system only accepts a whole number of 1 or more for this field. It cannot accept a fraction.

How to add a new cryptocurrency?

Take the example of SOL. One whole SOL is worth far more than 1 EUR. If you try to add the code SOL directly, the correct multiplier is a fraction, well under 1. The form rejects a fractional multiplier.

The solution is the same one we already use for BTC and ETH. Define the new currency as a small fraction of one coin. Make sure one unit of the new currency is worth close to, or less than, 1 EUR. For SOL, one thousandth of a coin is a reasonable fraction to start from. Call it MSOL.

Step 1: Open the Identity Settings template

1. Go to app.hizi.io.
2. Open App > Partners > Identity Settings - Templates.
3. Open the settings template used by the operator's Identity (an Identity is an operator brand). Or create a new template if the operator does not have one yet.

Step 2: Add the custom currency

1. Scroll to the "Custom currencies" section of the template. Do not confuse this with the "Custom currencies multipliers" section above it. That section only overrides the multiplier for an existing known currency code. "Custom currencies" defines a brand-new code.
2. Click "Add" to create a new row.
3. Set Currency code to MSOL. A currency code must be 3 or 4 characters.
4. Set Multiplier to a whole number, 1 or higher (see the next step for how to pick it).
5. Save the template.

Step 3: Choose the multiplier value

Estimate how many units of the new currency equal about 1 EUR, at current market prices. Round the result to a whole number.

Worked example: say 1 SOL is worth about 150 EUR today. Then 1 MSOL (0.001 SOL) is worth about 0.15 EUR. It takes roughly 7 MSOL to equal 1 EUR. A multiplier of 7 is a reasonable starting point. Treat this as an example calculation, not a live rate. Check the coin's actual price before you set the real value.

A crypto coin's price can move a lot in a short time. This multiplier is a fixed number. It does not update automatically when the coin's price changes. Revisit it manually if the coin's value drifts far from what the multiplier assumes.

Step 4: Confirm the operator sends the right currency code

The operator's game launch call must send currency: "MSOL" for the player. Check two more settings in the same template, since either one can block the new currency:

• Currencies restricted: if this list is set and does not include MSOL, the system blocks launches with MSOL.
• Fixed currency: if this is set, it overrides whatever currency the operator sends.

The operator's own wallet must also track player balances in MSOL. It must use the same 1/100-unit integer convention when it answers our debit and credit calls.

Important! Cryptocurrencies have little to no standardisation. Be careful with the values and codes you assign. You are responsible for confirming that they are correct. Confirm that the values match the desired multipliers.