Multi-Currency Conversion - MCC

Multi-Currency Conversion allows the merchant to sell products and services in a variety of currencies but receive their funding from Elavon in just one currency. MCC is beneficial to merchants with websites that target particular demographics in countries other than their own.

For example, a US merchant’s website targets customers in Europe, displays prices in Euro (EUR), processes payments in EUR but clears payments in US Dollars (USD) through a US bank account. Another example is a Canadian merchant’s website that targets customers in Australia, processes transactions in Australian Dollars (AUD), and deposits payments in Canadian Dollars (CAD) to a Canadian bank account.

When a terminal is set up with the Multi-Currency  option:

  • By default, the terminal can process transactions in the following currencies: US Dollar (USD), Canadian Dollar (CAD), Pound Sterling (GBP), Australian Dollar (AUD), Euro (EUR), and Japanese Yen (YEN).
  • The terminal only supports MCC transactions paid with MasterCard and Visa. For other card brands, the terminal can only process transactions using the USD or CAD currency.
  • The terminal only allows auto-settlement.

The following Credit Card transactions support MCC:

Transaction Processing

To process a credit card transaction for multi-currency conversion, the transaction request must include the ssl_transaction_currency and ssl_amount parameters.

Converge uses the exchange rates provided by Elavon’s designated currency exchange desk provider to convert the transaction amount from the submission currency to the single funding currency on the merchant’s account.

If the original transaction needs adjustment (through cccomplete, ccvoid, ccupdatetip or ccreturn), exclude the ssl_transaction_currency parameter from the request. The mentioned transactions will carry the original value of the transaction currency in the request.

For the ssl_amount value, use the number of decimal places that corresponds to the currency code passed to the ssl_transaction_currency parameter. Most currencies support 2 exponents (decimal places) except for few of them mentioned below. But Converge automatically rounds up (1.236 to 1.24) or rounds down (1.235 to 1.23) the transaction amount to 2 exponents.

Currency CodeCurrency NameExponents
AEDUnited Arab Emirates Dirham2
ANGNetherlands Antillean Guilder2
ARSArgentine Peso2
AWGAruban Florin2
AZNAzerbaijani Manat2
BBDBarbados Dollar2
BDTBangladeshi Taka2
BGNBulgarian Lev2
BHDBahraini Dinar3
BMDBermudian Dollar2
BOBBolivian Boliviano2
BRLBrazilian Real2
BSDBahamian Dollar2
BWPBotswana Pula2
CADCanadian Dollar2
CDFCongolese Franc2
CHFSwiss Franc2
CLPChilean Peso0
CNYChina Yuan Renminbi2
COPColombian Peso2
CRCCosta Rican Colon2
CZKCzech Koruna2
DKKDanish Krone2
DOPDominican Peso2
DZDAlgerian Dinar2
EEKEstonian Kroon2
EGPEgyptian Pound2
ETBEthiopian Birr2
EUREuro2
FJDFiji Dollar2
GBPPound Sterling2
GTQGuatemalan Quetzal2
HKDHong Kong Dollar2
HRKCroatian Kuna2
HTGHaitian Gourde2
HUFHungarian Forint2
IDRIndonesian Rupiah2
ILS(New) Israeli Shekel2
INRIndian Rupee2
IRRIranian Rial2
ISKIcelandic Króna0
JMDJamaican Dollar2
JODJordanian Dinar3
JPYJapanese Yen0
KESKenyan Shilling2
KRWSouth Korean Won0
KWDKuwaiti Dinar3
KZTKazakhstan Tenge2
LBPLebanese Pound2
LKRSri Lanka Rupee2
LSLLesotho Loti2
LTLLithuanian Litas2
LVLLatvian Lats2
LYDLibyan Dinar3
MADMoroccan Dirham2
MKDMacedonian Denar2
MURMauritian Rupee2
MWKMalawian Kwacha2
MXNMexican Peso2
MYRMalaysian Ringgit2
NADNamibian Dollar2
NGNNigerian Naira2
NOKNorwegian Krone2
NPRNepalese Rupee2
NZDNew Zealand Dollar2
OMROmani Rial3
PENPeruvian Nuevo Sol2
PHPPhilippine Peso2
PKRPakistani Rupee2
PLNPolish Zloty2
QARQatari Rial2
RONRomanian New Leu2
RSDSerbian Dinar2
RUBRussian Ruble2
SARSaudi Riyal2
SEKSwedish Krona2
SGDSingapore Dollar2
SYPSyrian Pound2
THBThai Baht2
TNDTunisian Dinar3
TRY(New) Turkish Lira2
TTDTrinidad and Tobago Dollar2
TWDNew Taiwan Dollar2
UAHUkrainian Hryvnia2
USDUS Dollar2
VEFVenezuelan Bolivar Fuerte2
VNDVietnamese Don0
XAFGabon Franc0
XCDEast Caribbean Dollar2
XOFIvory Coast Franc0
XPFFrench Polynesian Franc0
ZARSouth African Rand2
ZMKZambian Kwacha2
ZWLZimbabwe Dollar2

note

  • For JPY, there are no exponents after the decimal point. Any number after the decimal point is ignored.
  • For ISK, the currency decimalization is changed from ‘2’ to ‘0’ for Authorizations and Submissions.

Example

important

  • In this example, you will have to change the data values, such as my_merchant_id, my_user_id, my_pin, and transaction data to match your Converge account and meet the needs of your website.
  • Code samples provided are for demonstration only and should not be used for live transactions. All sensitive merchant data, including transaction amounts and your Converge credentials, should be placed in server side code.

Request

    xmldata=
    <txn>
        <ssl_merchant_id>my_merchant_id</ssl_merchant_id>
        <ssl_user_id>my_user_id</ssl_user_id>
        <ssl_pin>my_pin</ssl_pin>
        <ssl_test_mode>false</ssl_test_mode>
        <ssl_transaction_type>ccsale</ssl_transaction_type>
        <ssl_card_number>0000000000000000</ssl_card_number>
        <ssl_exp_date>1219</ssl_exp_date>
        <ssl_amount>200</ssl_amount>
        <ssl_transaction_currency>JPY</ssl_transaction_currency>
    </txn>

Response

    xmldata=
    <txn>
        <ssl_card_number>00********0000</ssl_card_number>
        <ssl_exp_date>1219</ssl_exp_date>
        <ssl_amount>200</ssl_amount>
        <ssl_transaction_currency>JPY</ssl_transaction_currency>
        <ssl_result>0</ssl_result>
        <ssl_result_message>APPROVAL</ssl_result_message>
        <ssl_txn_id>AA47AE-BD32FF54-BE12-4046-98E9- F78E9D75212D</ssl_txn_id>
        <ssl_approval_code>N05465</ssl_approval_code>
        <ssl_txn_time>11/19/2013 12:02:29 AM</ssl_txn_time>
    </txn>