graduation-capCurrency Tutorial

Supported currencies

The Emporix e-commerce system supports all existing currencies.

When creating a tenant on the Emporix Developer Portal, you can choose one of the following currencies:

  • EUR — Euro

  • GBP — Pound sterling

  • NOK — Norwegian krone

  • USD — United States dollar

circle-exclamation

If your business operates in a currency that's not listed on the Emporix Developer Portal, you need to perform the following steps:

  1. Choose one of the available currencies and finish creating your tenant.

  2. Get your Emporix API keys from the Emporix Developer Portal.

  3. Change your tenant's currency configuration.

Currency configurations

Currencies are configured both tenant-wide and independently for particular sites.

circle-exclamation

Currency codes defined in currency configurations must be compliant with the ISO 4217 standardarrow-up-right.

Your tenant's currency configuration is stored under the project_curr key in the Emporix API Configuration Service. Check out the following example:

Site-specific currency configuration is stored in the currency field, inside the Site object. Check out the following example:

circle-exclamation

Managing currency configurations through Emporix API

Check out the following tutorials to learn more about currency configuration with Emporix API.

How to check which currencies are configured for your tenant

To retrieve your tenant's currency configuration, you need to send a request to the Retrieving a configurationarrow-up-right endpoint.

circle-check
rectangle-terminalAPI Referencechevron-right

You can also get a list of all the currencies for your tenant by sending a request to the Retrieving all currenciesarrow-up-right endpoint.

rectangle-terminalAPI Referencechevron-right

How to change your tenant's currency configuration

To change your tenant's currency configuration, you need to send a request to the Updating a configurationarrow-up-right endpoint with updated currency information in the request body.

circle-exclamation
rectangle-terminalAPI Referencechevron-right

How to check which currency is configured for a particular site

To retrieve a particular site's currency configuration, you need to call the Retrieving a sitearrow-up-right endpoint. The currency configuration will be returned under the currency field in the response body.

rectangle-terminalAPI Referencechevron-right

How to change a particular site's currency configuration

To change a particular site's currency configuration, you need to call the Partially updating a site arrow-up-rightendpoint with the currency code of your choice in the request body.

circle-exclamation
rectangle-terminalAPI Referencechevron-right

Last updated

Was this helpful?