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
The standard tracking code is:
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:
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!