Currency Conversion

Error message

Tutorial 3ds2-exemptions-ReD is unknown

Currency Conversion

The currencies endpoint provides currency conversion information that you can use in your application. The base currency is determined by your account setup and the value provided for each currency is calculated based from the base currency.

Currency conversion rates can vary by scheme (paymentBrand), so each rate is specific to a particular paymentBrand in conversionRates.paymentBrand. The schemes for which rates are returned for a determined by your account setup.

Request

To retrieve the currency conversion information simply make a HTTP GET request, appending your authentication parameters, as follows:

Response

The response returns a conversionRates.rates JSON list which includes the rates for each currency, per paymentBrand.

{
    "id": "8a8294494d70bb1d014d71f41d250ce0",
    "result": {
        "code": "000.000.000",
        "description": "Transaction succeeded"
    },
    "conversionRates": [
        {
            "id": "321000000001",
            "paymentBrand": "VISA",
            "rates": [
                {
                    "currency": "CAD",
                    "currencyCode": "124",
                    "decimalPlaces": 2,
                    "roundUnit": 0,
                    "value": "0.8719914"
                },
                {
                    "currency": "EUR",
                    "currencyCode": "978",
                    "decimalPlaces": 2,
                    "roundUnit": 0,
                    "value": "1.3037524"
                },
                {
                    "currency": "GBP",
                    "currencyCode": "826",
                    "decimalPlaces": 2,
                    "roundUnit": 0,
                    "value": "1.6055084"
                },
                {
                    "currency": "IDR",
                    "currencyCode": "360",
                    "decimalPlaces": 0,
                    "roundUnit": 0,
                    "value": "0.0000825"
                },
                {
                    "currency": "JPY",
                    "currencyCode": "392",
                    "decimalPlaces": 0,
                    "roundUnit": 0,
                    "value": "0.0093024"
                },
                {
                    "currency": "KWD",
                   "currencyCode": "414",
                    "decimalPlaces": 3,
                    "roundUnit": 0,
                    "value": "3.3778381"
                },
                {
                    "currency": "LBP",
                    "currencyCode": "422",
                    "decimalPlaces": 2,
                    "roundUnit": 0,
                    "value": "0.0006345"
                }
            ]
        }
    ],
    "buildNumber": "20150520-101011.r183827.opp-tags-20150521_lr",
    "timestamp": "2015-05-20 15:32:14+0000",
    "ndc": "015acef3aefb43dfabae1dcfd4a919b1"
}

Integrating currency conversion data

We recommend that you retrieve this data once per day to ensure rates are always up-to-date.