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.

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.