# Currencies

Commerce provides support for products to be priced, displayed and sold in multiple currencies.

The active currency can be switched in real-time without the need to reset or clear the cart.

# Support

Commerce supports the display of the following currencies:

  • AUD
  • CAD
  • EUR
  • GBP
  • JPY
  • NZD
  • USD

If you would like support for another currency please let us know.

UI - Cart - Currency 1

# Settings

To allow a currency to be used with your account you must first enable it within the settings.

# Demo

View our Currency Demo to see the real-time multi-currency system in action.

# Definition

Selling a product in multiple currencies requires that a price be provided per currency.

In situations where a currency code is not explicitly provided, the price is considered to be in the default currency for the instance.

  • Simple price - No currency code
    This price is considered to be in the default currency for the instance.

    {
      "dimensions": {
        "height": 2,
        "length": 3,
        "weight": 18,
        "width": 2
      },
      "id": "simple1",
      "image": "https://demo.static.tools/media/images/simple-001.jpg",
      "name": "Galaxy Earings",
      "price": 17
    }
    
  • Price lists - No currency codes
    These prices are considered to be in the default currency for the instance.

    {
      "dimensions": {
        "height": 2,
        "length": 3,
        "weight": 18,
        "width": 2
      },
      "id": "simple1",
      "image": "https://demo.static.tools/media/images/simple-001.jpg",
      "name": "Galaxy Earings",
      "price": {
        "default": 17,
        "vip": 13,
        "wholesale": 10
      }
    }
    
  • Multi-currency
    These prices are in the currencies specified.

    {
      "dimensions": {
        "height": 2,
        "length": 3,
        "weight": 18,
        "width": 2
      },
      "id": "simple1",
      "image": "https://demo.static.tools/media/images/simple-001.jpg",
      "name": "Galaxy Earings",
      "price": {
        "default": {
          "AUD": 17,
          "EUR": 10,
          "USD": 11
        },
        "vip": {
          "AUD": 13,
          "EUR": 8,
          "USD": 9
        },
        "wholesale": {
          "AUD": 10,
          "EUR": 6,
          "USD": 7
        }
      }
    }
    

TIP

For more information see the Product Definition Guide.

Last Updated: 12/18/2019, 3:38:06 AM