International Support

The Unified Commerce Platform offers international support for a number of languages and currencies when it comes to processing orders from sites. Orders can be created and paid for in supported currencies, but these currencies may not always have their associated language translated in notifications or messaging. User interfaces are more limited, as the Fulfiller interface is the only one that is currently translated to another language (French), but additional language packs may be developed in the future as needed.

This guide lists the supported languages and currencies in these different areas of UCP.

Commerce Languages

Event notifications sent from Kibo during the fulfillment process are only available in English but translated email messaging may be supported depending on the site. This is determined by the locale that is set at site creation; the same site cannot send emails or translations for languages from other locales. In general, it is best to assume that the platform will use English and test for other languages as needed with the assistance of the Kibo Project Team. For more information about customizing email templates in both English and other languages, see Email Template Customization.

When creating a site (System > Structure > Sites), a country code is chosen that determines the locale. The site theme will reference localized data based on this locale. If localized data does not exist, the standard American English template will be used instead.

The site provisioning configurations with options for country codes

Interface Languages

Unified Commerce currently supports American English and French languages for the Admin UI and the Fulfiller UI. These versions are provided as "language files" in your UI theme, which are prepopulated with text labels in the appropriate language but can be customized as needed.

For more information about language files and customization see the Admin and Fulfiller theme guides. The labels used in language files also extend to translated email templates.

Other language packs may be made available as part of your implementation if desired. Contact your Kibo Project Team or Support for more information.

Supported Currencies

Many ISO currency codes can be supported, but each site can only support one currency and no-operation payment gateways may need to be built to process some currencies. This means that one site cannot support orders in multiple currencies. If an implementation needs to create orders in different currencies, then a site must be made for each currency. Then the necessary payment gateways can be configured on a per-site basis. 

The full list of ISO codes supported by Unified Commerce is provided below.

{
 "totalCount": 162,
 "items": [
  {
   "code": "AED",
   "name": "United Arab Emirates Dirham"
  },
  {
   "code": "AFN",
   "name": "Afghanistan Afghani"
  },
  {
   "code": "ALL",
   "name": "Albania Lek"
  },
  {
   "code": "AMD",
   "name": "Armenia Dram"
  },
  {
   "code": "ANG",
   "name": "Netherlands Antilles Guilder"
  },
  {
   "code": "AOA",
   "name": "Angola Kwanza"
  },
  {
   "code": "ARS",
   "name": "Argentina Peso"
  },
  {
   "code": "AUD",
   "name": "Australia Dollar"
  },
  {
   "code": "AWG",
   "name": "Aruba Guilder"
  },
  {
   "code": "AZN",
   "name": "Azerbaijan New Manat"
  },
  {
   "code": "BAM",
   "name": "Bosnia and Herzegovina Convertible Marka"
  },
  {
   "code": "BBD",
   "name": "Barbados Dollar"
  },
  {
   "code": "BDT",
   "name": "Bangladesh Taka"
  },
  {
   "code": "BGN",
   "name": "Bulgaria Lev"
  },
  {
   "code": "BHD",
   "name": "Bahrain Dinar"
  },
  {
   "code": "BIF",
   "name": "Burundi Franc"
  },
  {
   "code": "BMD",
   "name": "Bermuda Dollar"
  },
  {
   "code": "BND",
   "name": "Brunei Darussalam Dollar"
  },
  {
   "code": "BOB",
   "name": "Bolivia Boliviano"
  },
  {
   "code": "BRL",
   "name": "Brazil Real"
  },
  {
   "code": "BSD",
   "name": "Bahamas Dollar"
  },
  {
   "code": "BTN",
   "name": "Bhutan Ngultrum"
  },
  {
   "code": "BWP",
   "name": "Botswana Pula"
  },
  {
   "code": "BYR",
   "name": "Belarus Ruble"
  },
  {
   "code": "BZD",
   "name": "Belize Dollar"
  },
  {
   "code": "CAD",
   "name": "Canada Dollar"
  },
  {
   "code": "CDF",
   "name": "Congo/Kinshasa Franc"
  },
  {
   "code": "CHF",
   "name": "Switzerland Franc"
  },
  {
   "code": "CLP",
   "name": "Chile Peso"
  },
  {
   "code": "CNY",
   "name": "China Yuan Renminbi"
  },
  {
   "code": "COP",
   "name": "Colombia Peso"
  },
  {
   "code": "CRC",
   "name": "Costa Rica Colon"
  },
  {
   "code": "CUC",
   "name": "Cuba Convertible Peso"
  },
  {
   "code": "CUP",
   "name": "Cuba Peso"
  },
  {
   "code": "CVE",
   "name": "Cape Verde Escudo"
  },
  {
   "code": "CZK",
   "name": "Czech Republic Koruna"
  },
  {
   "code": "DJF",
   "name": "Djibouti Franc"
  },
  {
   "code": "DKK",
   "name": "Denmark Krone"
  },
  {
   "code": "DOP",
   "name": "Dominican Republic Peso"
  },
  {
   "code": "DZD",
   "name": "Algeria Dinar"
  },
  {
   "code": "EGP",
   "name": "Egypt Pound"
  },
  {
   "code": "ERN",
   "name": "Eritrea Nakfa"
  },
  {
   "code": "ETB",
   "name": "Ethiopia Birr"
  },
  {
   "code": "EUR",
   "name": "Euro Member Countries"
  },
  {
   "code": "FJD",
   "name": "Fiji Dollar"
  },
  {
   "code": "FKP",
   "name": "Falkland Islands (Malvinas) Pound"
  },
  {
   "code": "GBP",
   "name": "United Kingdom Pound"
  },
  {
   "code": "GEL",
   "name": "Georgia Lari"
  },
  {
   "code": "GGP",
   "name": "Guernsey Pound"
  },
  {
   "code": "GHS",
   "name": "Ghana Cedi"
  },
  {
   "code": "GIP",
   "name": "Gibraltar Pound"
  },
  {
   "code": "GMD",
   "name": "Gambia Dalasi"
  },
  {
   "code": "GNF",
   "name": "Guinea Franc"
  },
  {
   "code": "GTQ",
   "name": "Guatemala Quetzal"
  },
  {
   "code": "GYD",
   "name": "Guyana Dollar"
  },
  {
   "code": "HKD",
   "name": "Hong Kong Dollar"
  },
  {
   "code": "HNL",
   "name": "Honduras Lempira"
  },
  {
   "code": "HRK",
   "name": "Croatia Kuna"
  },
  {
   "code": "HTG",
   "name": "Haiti Gourde"
  },
  {
   "code": "HUF",
   "name": "Hungary Forint"
  },
  {
   "code": "IDR",
   "name": "Indonesia Rupiah"
  },
  {
   "code": "ILS",
   "name": "Israel Shekel"
  },
  {
   "code": "IMP",
   "name": "Isle of Man Pound"
  },
  {
   "code": "INR",
   "name": "India Rupee"
  },
  {
   "code": "IQD",
   "name": "Iraq Dinar"
  },
  {
   "code": "IRR",
   "name": "Iran Rial"
  },
  {
   "code": "ISK",
   "name": "Iceland Krona"
  },
  {
   "code": "JEP",
   "name": "Jersey Pound"
  },
  {
   "code": "JMD",
   "name": "Jamaica Dollar"
  },
  {
   "code": "JOD",
   "name": "Jordan Dinar"
  },
  {
   "code": "JPY",
   "name": "Japan Yen"
  },
  {
   "code": "KES",
   "name": "Kenya Shilling"
  },
  {
   "code": "KGS",
   "name": "Kyrgyzstan Som"
  },
  {
   "code": "KHR",
   "name": "Cambodia Riel"
  },
  {
   "code": "KMF",
   "name": "Comoros Franc"
  },
  {
   "code": "KPW",
   "name": "Korea (North) Won"
  },
  {
   "code": "KRW",
   "name": "Korea (South) Won"
  },
  {
   "code": "KWD",
   "name": "Kuwait Dinar"
  },
  {
   "code": "KYD",
   "name": "Cayman Islands Dollar"
  },
  {
   "code": "KZT",
   "name": "Kazakhstan Tenge"
  },
  {
   "code": "LAK",
   "name": "Laos Kip"
  },
  {
   "code": "LBP",
   "name": "Lebanon Pound"
  },
  {
   "code": "LKR",
   "name": "Sri Lanka Rupee"
  },
  {
   "code": "LRD",
   "name": "Liberia Dollar"
  },
  {
   "code": "LSL",
   "name": "Lesotho Loti"
  },
  {
   "code": "LTL",
   "name": "Lithuania Litas"
  },
  {
   "code": "LVL",
   "name": "Latvia Lat"
  },
  {
   "code": "LYD",
   "name": "Libya Dinar"
  },
  {
   "code": "MAD",
   "name": "Morocco Dirham"
  },
  {
   "code": "MDL",
   "name": "Moldova Leu"
  },
  {
   "code": "MGA",
   "name": "Madagascar Ariary"
  },
  {
   "code": "MKD",
   "name": "Macedonia Denar"
  },
  {
   "code": "MMK",
   "name": "Myanmar (Burma) Kyat"
  },
  {
   "code": "MNT",
   "name": "Mongolia Tughrik"
  },
  {
   "code": "MOP",
   "name": "Macau Pataca"
  },
  {
   "code": "MRO",
   "name": "Mauritania Ouguiya"
  },
  {
   "code": "MUR",
   "name": "Mauritius Rupee"
  },
  {
   "code": "MVR",
   "name": "Maldives (Maldive Islands) Rufiyaa"
  },
  {
   "code": "MWK",
   "name": "Malawi Kwacha"
  },
  {
   "code": "MXN",
   "name": "Mexico Peso"
  },
  {
   "code": "MYR",
   "name": "Malaysia Ringgit"
  },
  {
   "code": "MZN",
   "name": "Mozambique Metical"
  },
  {
   "code": "NAD",
   "name": "Namibia Dollar"
  },
  {
   "code": "NGN",
   "name": "Nigeria Naira"
  },
  {
   "code": "NIO",
   "name": "Nicaragua Cordoba"
  },
  {
   "code": "NOK",
   "name": "Norway Krone"
  },
  {
   "code": "NPR",
   "name": "Nepal Rupee"
  },
  {
   "code": "NZD",
   "name": "New Zealand Dollar"
  },
  {
   "code": "OMR",
   "name": "Oman Rial"
  },
  {
   "code": "PAB",
   "name": "Panama Balboa"
  },
  {
   "code": "PEN",
   "name": "Peru Nuevo Sol"
  },
  {
   "code": "PGK",
   "name": "Papua New Guinea Kina"
  },
  {
   "code": "PHP",
   "name": "Philippines Peso"
  },
  {
   "code": "PKR",
   "name": "Pakistan Rupee"
  },
  {
   "code": "PLN",
   "name": "Poland Zloty"
  },
  {
   "code": "PYG",
   "name": "Paraguay Guarani"
  },
  {
   "code": "QAR",
   "name": "Qatar Riyal"
  },
  {
   "code": "RON",
   "name": "Romania New Leu"
  },
  {
   "code": "RSD",
   "name": "Serbia Dinar"
  },
  {
   "code": "RUB",
   "name": "Russia Ruble"
  },
  {
   "code": "RWF",
   "name": "Rwanda Franc"
  },
  {
   "code": "SAR",
   "name": "Saudi Arabia Riyal"
  },
  {
   "code": "SBD",
   "name": "Solomon Islands Dollar"
  },
  {
   "code": "SCR",
   "name": "Seychelles Rupee"
  },
  {
   "code": "SDG",
   "name": "Sudan Pound"
  },
  {
   "code": "SEK",
   "name": "Sweden Krona"
  },
  {
   "code": "SGD",
   "name": "Singapore Dollar"
  },
  {
   "code": "SHP",
   "name": "Saint Helena Pound"
  },
  {
   "code": "SLL",
   "name": "Sierra Leone Leone"
  },
  {
   "code": "SOS",
   "name": "Somalia Shilling"
  },
  {
   "code": "SPL",
   "name": "Seborga Luigino"
  },
  {
   "code": "SRD",
   "name": "Suriname Dollar"
  },
  {
   "code": "STD",
   "name": "Sao Principe and Tome Dobra"
  },
  {
   "code": "SVC",
   "name": "El Salvador Colon"
  },
  {
   "code": "SYP",
   "name": "Syria Pound"
  },
  {
   "code": "SZL",
   "name": "Swaziland Lilangeni"
  },
  {
   "code": "THB",
   "name": "Thailand Baht"
  },
  {
   "code": "TJS",
   "name": "Tajikistan Somoni"
  },
  {
   "code": "TMT",
   "name": "Turkmenistan Manat"
  },
  {
   "code": "TND",
   "name": "Tunisia Dinar"
  },
  {
   "code": "TOP",
   "name": "Tonga Pa anga"
  },
  {
   "code": "TRY",
   "name": "Turkey Lira"
  },
  {
   "code": "TTD",
   "name": "Trinidad and Tobago Dollar"
  },
  {
   "code": "TVD",
   "name": "Tuvalu Dollar"
  },
  {
   "code": "TWD",
   "name": "Taiwan New Dollar"
  },
  {
   "code": "TZS",
   "name": "Tanzania Shilling"
  },
  {
   "code": "UAH",
   "name": "Ukraine Hryvna"
  },
  {
   "code": "UGX",
   "name": "Uganda Shilling"
  },
  {
   "code": "USD",
   "name": "US Dollar"
  },
  {
   "code": "UYU",
   "name": "Uruguay Peso"
  },
  {
   "code": "UZS",
   "name": "Uzbekistan Som"
  },
  {
   "code": "VEF",
   "name": "Venezuela Bolivar Fuerte"
  },
  {
   "code": "VND",
   "name": "Viet Nam Dong"
  },
  {
   "code": "VUV",
   "name": "Vanuatu Vatu"
  },
  {
   "code": "WST",
   "name": "Samoa Tala"
  },
  {
   "code": "XDR",
   "name": "IMF Special Drawing Rights"
  },
  {
   "code": "XOF",
   "name": "CFA (BCEAO) Franc"
  },
  {
   "code": "XPF",
   "name": "CFP Franc"
  },
  {
   "code": "YER",
   "name": "Yemen Rial"
  },
  {
   "code": "ZAR",
   "name": "South Africa Rand"
  },
  {
   "code": "ZMK",
   "name": "Zambia Kwacha"
  },
  {
   "code": "ZWD",
   "name": "Zimbabwe Dollar"
  }
 ]
}

Was this page helpful?

YesNo