International Support

The Kibo Composable Commerce Platform (KCCP) 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. 

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

Commerce Languages

Event notifications sent from Kibo during the fulfillment process are only available in English, but consumer email messaging can be sent in other languages 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. 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. If localized data for that country code and associated language does not exist, then American English will be used instead. 

In general, it is best to assume that the platform will use English and test for other languages as needed with the assistance of Kibo. However, here is a list of common IETF language tags that Kibo supports. Contact your Kibo Project Team or Kibo Support if you have questions about any additional languages not listed below.

User Interface Languages

Localization is provided as "language files" in your theme, which are prepopulated with text labels but can be customized as needed. For details about how to edit your Fulfiller UI to add any language, see the Fulfiller theme guide. Contact Kibo Support about Admin UI localization.

Non-ZIP Code Addresses

Some countries, such as the United Arab Emirates, do not use addresses with ZIP codes. Although the Order Routing service usually references ZIP codes to obtain latitude/longitude coordinates of location candidates during routing, the system does support addresses without ZIP codes. In these cases, Inventory and Order Routing will use the entire provided address to look up the latitude/longitude instead.

See the Order Routing documentation for more information on how locations are selected for routing.

Metric vs. Imperial Measurements

You can select whether a fulfillment location uses the metric or imperial system for entering package measurements in their location group configurations.

However, the product catalog does not currently have an option to use metric units. When configuring a product's shipping options, the Admin UI will only display inches. Even if you specify metric units via the Product API (using the packageHeight, packageWidth, packageDepth, and packageWeight fields), those values will still be displayed as inches in the UI. Support for the metric system in the catalog will be added in the future.

Supported Currencies

Many ISO-4217 currency codes can be supported by Kibo, but each site can only use one currency and no-operation payment gateways may need to be built to process some 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. 

Currencies that use three decimal places (such as Kuwaiti Dinar, Rial Omani, and Bahraini Dinar) are also supported in the Kibo Composable Commerce Platform APIs and UIs. This includes the Cart, Checkout, and My Account pages on the Storefront as well as the Orders, Customer, B2B, Returns, and Shipping Setting UIs in the Admin. Currencies that typically only use two decimal places, such as USD, will always show two decimal points.

The full list of ISO codes supported by KCCP 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"
  }
 ]
}

Reporting Currencies

However, standard out-of-the-box reports and Reporting dashboards display all values in USD by default and will convert any non-USD values. If you want to display reports in currencies other than USD, you must have Kibo change your default during implementation or make create custom reports based on the "transactional" field instead. 

For more information, see the Reporting documentation.