Dynamic Currency Conversion - Guide

In this guide, you'll learn how to obtain the relevant currency and exchange rate, present the option to the customer, and process the authorization. We also provide information on complying with requirements to display exchange rates and fees.

Before starting the steps in this guide, you must do the following:

• Get registered
• Create an app (generate keys)
• Create an access token

To start, we need to check if the card is available for DCC and what the current exchange rate is.

• If the card is eligible for DCC, you’ll receive an AVAILABLE status.
• If the card is not eligible for DCC or the card currency is the same as your base currency, you’ll receive a NOT_AVAILABLE status.

Sample request

   POST https://apis.sandbox.globalpay.com/ucp/currency-conversions

{
    "account_name": "dcc",
    "channel": "CNP",
    "amount": "2300",
    "currency": "EUR",
    "country": "GB",
    "reference": "ORDER_35359361",
    "payment_method": {
        "entry_mode": "ECOM",
        "card": {
            "number": "4006097467207025",
            "expiry_month": "12",
            "expiry_year": "25"
        }
    }
}   

Sample response

{
    "id": "CCS_LUAa1xpkuWeBPuREJXiA7Ua0ySQGHM",
    "time_created": "2021-06-30T16:05:02.491Z",
    "model": "FROM_TRANSACTION_CURRENCY",
    "status": "AVAILABLE",
    "country": "GB",
    "transaction_type": "SALE",
    "amount": "2300",
    "currency": "EUR",
    "exchange_rate": "1.6250",
    "payer_amount": "3738",
    "payer_currency": "AUD",
    "margin_rate_percentage": "03.7500",
    "exchange_rate_source": "REUTERS WHOLESALE INTERBANK",
    "exchange_rate_time_created": "2018-08-20T11:17",
    "commission_percentage": "00.0000",
    "merchant_id": "MER_c11ad71fb6474bb9b8d753e16ef35708",
    "merchant_name": "DCC_Test",
    "account_id": "TRA_cb12a5ccd1704066beab6a49d6f39cee",
    "account_name": "dcc",
    "reference": "ORDER_35359361",
    "payment_method": {
        "result": "00",
        "message": "Success",
        "card": {
            "brand": "VISA",
            "masked_number_last4": "XXXXXXXXXXXX7025"
        }
    },
    "action": {
        "id": "ACT_LUAa1xpkuWeBPuREJXiA7Ua0ySQGHM",
        "type": "RATE_LOOKUP",
        "time_created": "2021-06-30T16:05:02.491Z",
        "result_code": "SUCCESS",
        "app_id": "L6reqt6WUjenvyQi0PJgUsF6RUXU1tto",
        "app_name": "DCC_Test"
    }
}

Now that we have the card currency, exchange rate, and amount, we can present the option to the customer.

For this example, the card currency is Swedish Krona (SEK) and our base currency is Euro (EUR).

DCC Choice Example

Once the customer selects the currency, you can send the Authorization along with the DCC information to reflect the customer’s choice.

DCC CHOSEN

In this example, the customer has chosen to pay in the currency of their card. You can populate the converted amount, rate, and currency into the request.

Sample request

POST https://apis.sandbox.globalpay.com/ucp/transactions

{
    "account_name": "dcc",
    "type": "SALE",
    "channel": "CNP",
    "amount": "2300",
    "currency": "EUR",
    "country": "GB",
    "reference": "ORDER_35359361",
    "payment_method": {
        "first_name": "James",
        "last_name": "Mason",
        "entry_mode": "ECOM",
        "card": {
            "number": "4006097467207025",
            "expiry_month": "12",
            "expiry_year": "25",
            "cvv": "996"
        }
    },
    "currency_conversion": {
        "id": "CCS_g47zV5MsiNjRyX89lCx41xfIfF7G7f"
    }
}

DCC NOT_AVAILABLE or NOT_CHOSEN

In this example, DCC is not available or the customer has not chosen to pay in the currency of their card. No DCC data is submitted as part of the Authorization message.

Sample request

POST https://apis.sandbox.globalpay.com/ucp/transactions

{
    "account_name": "dcc",
    "type": "SALE",
    "channel": "CNP",
    "amount": "2300",
    "currency": "EUR",
    "country": "GB",
    "reference": "ORDER_35359361",
    "payment_method": {
        "entry_mode": "ECOM",
        "card": {
            "number": "4006097467207025",
            "expiry_month": "12",
            "expiry_year": "25",
            "cvv": "996"
        }
    }
}

Markup transparency rules

In April 2020, the European Union introduced new rules governing the transparency of a merchant markup on currency conversions for certain currencies in the European Economic Area (EEA). These currencies include: EUR, DKK, HUF, PLN, CZK, RON, and SEK. For merchants utilizing DCC, the EEA rules mean that if the exchange rate offered to the customer has a markup that makes the amount above the European Central Bank (ECB) exchange rate, this percentage rate must be displayed to the consumer.

When the customer is presented with the choice to pay in the currency of their card or the merchant’s base currency, the markup amount should be displayed to them. If the exchange rate offered is the same or less than the ECB rate, the markup should be displayed as 0%.

The value of the rate field returned in the Rate Lookup response will be the rate provided by the merchant or a third-party Currency Conversion Processor (CCP), inclusive of their markup. The value of the margin percentage field will reflect the markup rate of the merchant or CCP in relation to the current ECB rate.

HPP Example

Either the merchant or CCP provides the interbank exchange rate available at the time of transaction and displays it to the customer. This way, the customer knows the exchange rate before they complete the payment. They can then choose whether to continue with the conversion or pay in the merchant’s base currency.

When the customer is presented with the choice to pay in the currency of their card or the merchant’s base currency, the markup percentage and commission applied will be displayed to them. This can alleviate any concerns customers may have about any subsequent processing for foreign-exchange conversion.

In this example on our Hosted Payment Page (HPP), the base currency is British pound sterling (GPB) and the card currency is Hong Kong Dollar (HKD).

DCC Section with Compliance Information