Skip to content

Exchange Configuration

System Management > Exchange Configuration

Business rules are configurable settings which provide issuers control over the customer process during the 3-D Secure transactions. The Amount Threshold rule is used to determine whether authentication can be bypassed based on an amount threshold. To cater for this requirement, it is necessary to set a threshold amount in a default currency. Where the default currency is the same as the transaction currency, this calculation is straightforward. However, where these currencies differ, it is necessary to first convert the transaction currency to an equivalent value in the default currency before calculating whether the threshold has been exceeded. In order to compare the default currency and transaction currency values where they differ, it is necessary to maintain a list of currency exchange rates.

To automate the maintenance of currency exchange values, the ACS system has been configured to automatically download an external currency exchange rate resource file. Where this list of rates is not comprehensive, and a transaction is received which is in a currency not found on the automated list, this section provides the necessary functionality to manually create currency exchange values.

The Exchange Configuration page shows a list of manually configured currency rates. The Base Currency signifies the transaction currency whilst the Target Currency signifies the currency of the issuer threshold as configured in the currency value on the Amount Threshold rule page. The Rate value is used as a multiplier, to convert an amount in the Base Currency to an equivalent amount in the Target Currency. Manual exchange rates can be edited by clicking on the Base Currency link.

Links are provided to View automatic exchange rates and View effective exchange rates and Add for adding a manual exchange rate.

This page displays:

  • Manual Exchange Rates list

  • View automatic exchange rates link to the Automatic Exchange Rates page

  • View effective exchange rates link to the Effective Exchange Rates page

  • Add link to the Add Exchange Rate page

  • Delete button to allow selected exchange rates to be deleted

The following fields and links are displayed for each exchange rate:

  • Base Currency link to the Edit Exchange Currency page

  • Target Currency

  • Rate

  • Last Update - Shows the date and time the exchange rate was last updated.

Add Exchange Configuration

System Management > Exchange Configuration > Add > Add Exchange Rate

Use this page to add an exchange rate that is not supported by the automated currency exchange file.

Use the following fields to add a currency exchange rate:

  • Base Currency

  • Target Currency for the currency of the issuer threshold as configured in the currency value on the Amount Threshold rule page.

  • Rate which should be multiplied by the Base Currency to equal the amount in the Target Currency.

Warning

Note that values entered here take precedence over those rates obtained by the automatic exchange rates feed when they have been updated more recently than the automatic updates.

  • Apply button to save the currency exchange rate.

Edit Exchange Configuration

System Management > Exchange Configuration > Add > Edit Exchange Rate

Use this section to edit currency rates that have been manually created through the Exchange Rate section.

  • On the Exchange Configuration page, select the Base Currency link.

    The Edit Exchange Rate page is displayed.

  • The Base Currency and the Target Currency are displayed and cannot be changed.

  • Enter a value for the Rate which should be multiplied by the Base Currency to equal the amount in the Target Currency.

Warning

Note that values entered here take precedence over those rates obtained by the automatic exchange rates feed when they have been updated more recently than the automatic updates.

  • Apply button to save the currency exchange rate.

View Automatic Exchange Rates

Use this page to view the automatic exchange rates held in the system.

This page displays:

  • Automatic Exchange Rates list

  • View manual exchange rates

  • View effective exchange rates

  • Refresh list to update the list with the most recent exchange rates.

The following fields and links are displayed for each exchange rate:

  • Base Currency

  • Target Currency

  • Rate

  • Last Update - Shows the date and time the exchange rate was last updated.

CurrencyConvertor.properties file

You can specify the currency exchange settings by editing the CurrencyConvertor.properties file located in ActiveAccess' AA_HOME directory on the server. The following parameters are configurable in this file:

AUD_URL: Specifies the URL of the feed that provides Australian Dollar exchange rates. The default is http://www.rba.gov.au/rss/rss-cb-exchange-rates.xml.

MAX_UNSUCCESSFUL_TRY: Specifies the number of times an attempt can be made to connect to try to the exchange feed URL before giving up in the case of an error is displayed.

AUD_FILE_TYPE: Specifies the format of the currency feed for the Australian Dollar. Default is XML.

RETRY_INTERVAL: Specifies the time in seconds that the system waits before sending another request in the case of error. Default is 30.

AUD_DATE_PATTERN: Specifies the format for date and time.

UPDATE_PERIOD: Specifies how often exchange rates are updated (hours). Default is 24.

PROXY_HOST: If required specifies the proxy address to be used for connecting to the exchange feed. Default is blank.

PROXY_PORT: If required specifies the proxy port to be used for connecting to the exchange feed. Default is blank.

PROXY_USER: If required, specifies the user name to be used to connect via the proxy. Default is blank.

PROXY_PASSWORD: If required, specifies the password to be used for connecting via the proxy. Default is blank.

ActiveAccess server should be restarted for changes to take effect.

Note

Automatic Exchange Rates rely on access to the Internet or an external resource configured to retrieve these details. If no access is available, the following message is displayed "Loading effective exchange rates, please wait..."

View Effective Exchange Rate

Use this page to view the effective exchange rates.

This page displays:

  • Effective Exchange Rates list

  • View manual exchange rates link to the Manual Exchange Rates page

  • View automatic exchange rates link to the Automatic Exchange Rates page

  • Refresh list to update the list with the most recent exchange rates.

The following fields and links are displayed for each exchange rate:

  • Base Currency

  • Target Currency

  • Rate

  • Last Update - Shows the date and time the exchange rate was last updated.

Note

Effective Exchange Rates rely on access to the Internet or an external resource configured to retrieve these details. If no access is available, the following message is displayed "Loading effective exchange rates, please wait..."