3.5.3 Handling multiple currencies

When a new account is created, the currency is by default set based on the currency key in the AppSettings.config file.  

If you want to assign different currencies you can do it per country code. During the sign up procedure the country code is entered by user or detected by the app. The EMCD checks if there is any tariff to country code association in the api.signup_conifg table and if there is assigns the defined tariff. If there is no entry for a country code the default tariff is used.

There is no direct connection between the country code and account currency. Instead, this relation is through the account tariff. If you want users from a specific country to have for example GBP as the currency you need to add country code 44 and choose a tariff in GBP. The EMCD will check the tariff’s currency and will set it as the account currency. The api.signup_config table is managed through the VSM.

Assigning a currency on signup

To create an entry for a country go to the VSM Settings/RCS/Sign up menu and click the New button. The below window will open where you can choose a country from the drop down list and select a tariff.

Amount is related to the bonus feature described elsewhere. In short the amount set here is added on sign up. It is an optional setting and should be skipped if you want only to define a tariff.

You have to create new entries for all the countries which should use a currency that is different from the default one.

Top ups

Currency has to be reflected in the top up configuration. There are two methods of making top up from the mobile apps which is the iOS inApp Purchase and through the VUP Top Up page which is opened in a web view component.

iOS inApp Purchase

For the inApp Purchase you have to create products in the Appstore in the following format:

package.name.recharge.[XXX].[amount]

where XXX should be the ISO code of the currency and amount should represent the amount available to purchase. For example:

package.name.recharge.usd.5

package.name.recharge.usd.10

For each amount must be a separate product.

The softphone obtains the currency code from the account balance received from the EMCD API. When retrieving the products from the Appstore it shows only those products which match the client currency. For example if the client has the account balance 15 USD then the products shown will be only those defined with USD in the URI. Thus you can offer different top ups amounts for different currencies.

When a user selects the amount and confirms the purchase the softphone sends a request containing the product URI.

In the final step the softphone communicates with the onlineshop at the specified URL which usually has the following format:

https://[webserver_domain]/osi/Store.ashx

The request sent to the onlineshop carries only information about the amount to be added without having to specify the currency.

Android

Top up for android devices is done through the VUP Top Up page. In the VUP folder, go to the App_Config directory and open the TopUp.config file. It should contain a section with the onlineshop URL. The TopUp page connects to the onlineshop in order to retrieve the amounts, their currency and the supported payment methods.  If you allow for different currencies you have to add entries for all currencies and URLs of the onlineshops handling payments in given currency.

<?xml version="1.0"?>

<Rules>

 <Rule currency="USD" url="https:// [server_address]/OnlineShopUSD" />

 <Rule currency="EUR" url="https:// [server_address]/OnlineShopEUR" />

 <Rule currency="GBP" url="https://[server_address]/OnlineShopGPB" />

</Rules>

When the TopUp page link is opened from the softphone it adds the login and currency as parameters, e.g.:

https://DOMAIN/VUP/TopUp?l=SIP_LOGIN&ct=USD.

The currency code is obtained from the EMCD API’s balance method.