Android top up using 3rd party payment providers

For android devices the top up function is done through the VUP (portal) Top Up page. In the VUP folder, go to the App_Config directory and open the TopUp.config file. The file 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 list of supported payment providers. If you allow for multiple currencies you have to add entries for all currencies and the URLs of the onlineshops handling payments in given currency.

Example:

<?xml version="1.0"?>

<Rules>

</Rules>

The android softphone, when opening the TopUp page link, adds the login and the user's 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.

TopUp page customization

The TopUp page file is located at \VUP\Views\DialerFeatures\TopUp.cshtml

You can edit the cshtml file and modify its html code to change the page's layout. The styles are defined in the \Content\Features\topup.css file. There are definitions of colors, fonts and other properties.

Android top up using Google Play

Android softphone supports also payments through the Google's in app purchase system. You can learn more how to configure this method on your Google Play account here 5.2 Configure In-App payments - Google Play

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.

You can learn more on the inApp payment flow here: 1.13.2 Payment flow#1.13.2Paymentflow-inApp

Browser not supported