Locale and currency

Understand how to use locale and currency.

A locale designator combines the two-letter ISO 639-1 language code with the ISO 3166-1 alpha-2 country code (for example, en-US). When you set up your store in Global Commerce, you specified a default locale. Your store automatically shows the language and currency of the default locale.

The currency is a designator that uses a three-letter currency code to identify the currency.

When creating a shopper through Commerce API, the default locale and currency can be specified in the request body; if the locale and currency are not provided, it will use the default locale and currency for this shopper.

When creating a shopper through Commerce API, the default locale and currency can be specified in the request body; if the locale and currency are not provided, it will use the default locale and currency for this shopper.

{
  "shopper": {
    "username": "[e-mail]",
    "firstName": "Automation",
    "lastName": "Tester",
    "emailAddress": "[e-mail]",
    "password": "qwerasdf",
    "locale": "en_CH",
    "currency": "CHF",
    "sendmail": true,
    "sendEMail": true
  }
}

After the shopper adds a product to create a shopping cart, the locale and currency of the shopping cart will be the default for the current shopper's cart.

The shopper can update their default locale and currency for their current shopping cart by using the /shoppers/me endpoint.