Home > Post Affiliate Pro > Features and functions > Multiple currencies

Multiple currencies

How it works


Post Affiliate Pro uses one main currency, you can set it at Configuration > Currency. This is the currency for all commission settings, transactions and payouts. With the Multiple currencies feature you can define additional currencies, so that you can track sales  in different currencies, while in the merchant/affiliate panel the tracked transactions (commissions) will be displayed using the main currency after recomputing the tracked amount of foreign currency based on the defined 'exchange rate'. 


So, it is important to understand that even with the Multiple currencies feature activated, you'll see all your commissions only in the main currency. But it will allow you to register sales in shops using  different currency.

Activating the feature


This feature is available only in Professional edition downloadable license and Basic hosted plan. Users of the Xpress edition can purchase it individually.

The feature has to be activated before it can be used. To activate it go in your merchant panel to Configuration > Features. There click the Activate button next to the Multiple currencies feature. If you have Xpress edition, you have to buy it first. After this, the feature is activated. Now you can define additional currencies in the affiliate system.

Setting up additional currencies


All the currency related settings are configurable in the merchant panel at Configuration > Currency. When the feature is activated, you'll see a new checkbox Support multiple currencies. Checking it will open a new part of the particular window with additional currency specifications.



You can add another currency by clicking the Add currency button.



This will add a new line to the multiple currencies grid. You can edit the cells in the grid and specify the details of the new currency.

Name should be standard three letter currency code, like USD, EUR, GBP, etc.
Symbol is what is displayed next to the number value.
Precision is precision to which the currency should be rounded.
Where to display means the position of currency symbol; possible values: 1 = left,  2 = right.
Exchange rate is the most important setting, it is the exchange rate between the new currency and system default currency. This exchange rate will be used when the sale and commission value is recomputed from the new currency.

When you have specified all the currency parameters, click the Save modified rows button to save the grid, and then click the Save button to save the whole form.


Automatic exchange rate updater


If you are using official currency codes, you can use 'Automatic exchange rate updater' for updating exchange rates automatically. It is executed daily. You can enable it in feature configuration:

This function is based on CurrencyConvertor via www.webservicex.net/CurrencyConvertor.asmx, but if this service is down, feature will use Google Finance Currency Converter: www.google.com/finance/converter

Registering sales in different currency


Now that the new currency was defined, we can look at the way how we can tell the tracking script to register the commission in the different currency.We'll have to use an additional parameter in the JavaScript tracking  code.


The standard tracking code is:

<script id="pap_x2s6df8d" src="http://www.yoursite.com/affiliate/scripts/salejs.php" type="text/javascript">
</script>
<script type="text/javascript">
var sale = PostAffTracker.createSale();
sale.setTotalCost('120.50');
PostAffTracker.register();
</script>

This code will register a sale with total value of 120.50 USD - in the default currency. If we want to tell the script that the currency of this sale is EUR, we should call an additional function sale.setCurrency('EUR');.


So the complete script for tracking sale in EURos action is:

<script id="pap_x2s6df8d" src="http://www.yoursite.com/affiliate/scripts/salejs.php" type="text/javascript">
</script>
<script type="text/javascript">
var sale = PostAffTracker.createSale();
sale.setTotalCost('120.50');
sale.setCurrency('EUR');
PostAffTracker.register();
</script>

Note that the currency code you specify in the setCurrency function, first it must be defined in the merchant panel at Configuration > Currrency > Multiple currencies, otherwise it will be ignored!

That's all, now when this JavaScript code is displayed, it will register a sale with value of 120.50 EUR which is then recomputed to the main currency (USD) according to the exchange rate. So the value of the sale in USD will be: 120.50 x 1.36 (exchange rate) = 163.88 USD.

Quality Unit's products

LiveAgent

LiveAgent integrates live chat software and help desk software features into a single customer support solution.

Try it free

Post Affiliate Pro

Post Affiliate Pro is a full featured affiliate tracking software ready to power your own affiliate program.

Buy Now