About the Site Currency API

The Site Currency API allows you to manage which currencies can be displayed in a Wix store. When you enable currencies for a store, visitors can view prices in their preferred currency. Prices are automatically converted using up-to-date exchange rates.

Use this API to:

• Configure which currencies visitors can select in a store
• Retrieve the list of enabled currencies for a store
• Provide a localized pricing experience for international visitors

Key Concepts

• Currency conversion: When currencies are enabled for a store, Wix automatically converts prices from their original currency to the selected display currency using current exchange rates. The original prices in products, services, and other catalog items remain unchanged.

• Exchange rates: Exchange rates are managed automatically by Wix and updated regularly. You don't need to manage or configure exchange rates when using this API.

• Currency codes: This API accepts only valid ISO 4217 three-letter currency codes (such as USD, EUR, GBP). Invalid currency codes will be rejected.

How It Works

1. Set currencies: Use Set Currencies to define which currencies visitors can view prices in. The list you provide completely replaces any previously configured currencies.

2. Display currency selector: Once currencies are configured, users can display a currency selector on their site (typically a dropdown) where visitors choose their preferred currency.

3. Automatic conversion: When a visitor selects a currency, Wix automatically converts all prices on the site to that currency.

4. Disable conversion: To disable currency conversion entirely, call Set Currencies with an empty array.