Multiple currencies

Multiple currencies allow you to track sales in multiple currencies.

How it works

Post Affiliate Pro uses one main currency, you can set it in Configuration -> Currency. This is the currency for all commission settings, transactions and payouts. With Multiple currencies feature you can define additional currencies, and the system will then allow you to register sales in different currencies. 
Amounts are recomputed from other currency to the main currency at the time of sale registration.

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

Activating the feature

This feature is available only in Professional edition. Users of Starter and Xpress editions can purchase it individually.

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

Setting up the additional currencies

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

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

This will add 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, wher epossible values are 1 - left and 2 - right of the value number.
Exchange rate is the most important setting, it is the exchange rate between new currency and system default currency. This exchange rate will be used when the sale and commission value will be recomputed from the new currency.

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

Registering sales in different currency

Now that the new currency was defined, we can look at how we can tellthe tracking script to register commission in the different currency.We'll have to use additional parameter in the tracking JavaScript 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 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 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 must be defined first in th emultiple currencies, otherwise it is ignored!

That's all, now when this JavaScript code is displayed, it will register 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.