Как настроить валюты в OpenCart: пошаговая инструкция

В OpenCart 3.x вы можете добавить валюту, назначить её основной для магазина или дать покупателю переключать цены — настройка займёт примерно 15–30 минут. Ниже — последовательность действий и проверки, которые помогут не показать на витрине неверную сумму после изменения курса.

Что подготовить

• Доступ в административную панель с правами менять настройки магазина.
• Код валюты по ISO 4217, например USD или EUR. Не подбирайте его по символу: одинаковый знак может использоваться в разных странах.
• Значение курса относительно основной валюты магазина. Если не уверены, как именно его рассчитывает ваша версия OpenCart, сверьте подсказку поля в панели и проверьте результат на тестовой цене.
• Тестовый товар с известной ценой. Не меняйте валюты на рабочем магазине, пока не проверили, как пересчитываются цены и оформляется заказ.

Инструкция относится к ветке OpenCart 3.x. В OpenCart 4.x интерфейс и расположение пунктов могут отличаться: не переносите шаги автоматически, а сверяйте их с документацией именно вашей версии.

Шаг 1. Проверьте основную валюту

В административной панели откройте System → Settings, выберите магазин и нажмите редактирование. Перейдите на вкладку Local и найдите поле Currency. Здесь задаётся основная валюта магазина — от неё зависит, как OpenCart показывает цены и рассчитывает суммы в других валютах.

Запишите текущее значение до изменений. Если магазин уже принимает заказы, не переключайте основную валюту без проверки каталога, корзины, платёжного модуля и выгрузок: разные интеграции могут ожидать суммы в конкретной валюте.

Проверка: сохраните настройки и снова откройте их. В поле Currency должна отображаться выбранная основная валюта.

Шаг 2. Добавьте валюту

Откройте System → Localisation → Currencies и нажмите кнопку добавления. Заполните форму:

• Currency Title — понятное название, например «Евро».
• Code — код валюты по ISO 4217, например EUR. Проверьте код до сохранения: похожее название не гарантирует, что код правильный.
• Symbol Left и Symbol Right — знак перед суммой или после неё. Используйте только одно поле, если для вашей витрины это подходит.
• Decimal Places — число знаков после запятой. Обычно для валют с дробной частью используют два, но формат цены лучше сверить с требованиями вашей бухгалтерии и платёжного провайдера.
• Value — курс относительно основной валюты. Его смысл проверьте на тестовой цене: не вводите значение наугад.
• Status — включите валюту, если она должна быть доступна покупателям.

Сохраните запись. Если нужно несколько валют, добавляйте каждую отдельно и отдельно проверяйте код и курс.

Проверка: валюта появилась в списке, у неё правильные код, символ и статус. Если запись не сохранилась, проверьте обязательные поля и сообщения панели, а не повторяйте ввод с произвольными значениями.

Шаг 3. Решите, кто выбирает валюту

Если покупатель должен переключать валюту на витрине, оставьте её включённой и проверьте, что переключатель отображается в используемой теме. Если переключателя нет, причина может быть в теме или её настройках: наличие валюты в административном списке само по себе не гарантирует видимый элемент на сайте.

Если валюта должна быть основной для всех посетителей, вернитесь в настройки магазина и выберите её в поле Currency на вкладке Local. Это не то же самое, что просто добавить валюту: запись в справочнике не меняет основную валюту автоматически.

Проверка: откройте витрину в приватном окне браузера. Проверьте, что нужная валюта доступна, а после переключения цена меняется ожидаемым образом.

Шаг 4. Проверьте пересчёт на товаре и в заказе

Откройте страницу тестового товара, затем добавьте его в корзину. Сравните цену в карточке, корзине и оформлении заказа. Важно проверять всю цепочку: витрина может показывать одну валюту, а платёжный модуль — принимать другую.

1. Зафиксируйте цену товара в основной валюте.
2. Переключите витрину на добавленную валюту.
3. Сравните сумму с расчётом по курсу, который вы ввели. Учитывайте округление.
4. Добавьте товар в корзину и проверьте итог, включая доставку и налоги, если они настроены.
5. Создайте тестовый заказ безопасным способом, не проводя реальный платёж, если у вас нет тестового режима платёжного провайдера.

Проверка: суммы в карточке, корзине и заказе согласуются с настройками магазина и платёжного модуля. Если отличаются — не включайте валюту для покупателей, пока не выясните, на каком этапе меняется сумма.

Если не получилось

• Валюта есть в панели, но не видна на сайте. Проверьте статус валюты, настройки темы и наличие переключателя в выбранном макете.
• Сумма выглядит неправдоподобно большой или маленькой. Проверьте код валюты и значение курса. Пересчитайте цену вручную на тестовом товаре; не исправляйте проблему случайным увеличением или уменьшением курса.
• После сохранения цена не изменилась. Убедитесь, что открыли страницу именно этого магазина и переключили валюту на витрине. Затем очистите кэш, если он включён в теме или на хостинге, и повторите проверку.
• В карточке и при оформлении заказа разные валюты. Проверьте основную валюту магазина и настройки платёжного модуля. До выяснения причины отключите проблемный вариант оплаты или валюту для посетителей.
• В списке появились дубли. Проверьте коды валют и удалите только ненужную запись после того, как убедитесь, что на неё не ссылаются настройки или интеграции.

Добавленная валюта — ещё не проверенная оплата. Сначала проследите сумму от карточки товара до тестового заказа, и только потом показывайте переключатель покупателям.

Что делать дальше

После настройки проверьте валюту в платёжном модуле, доставке, налоговых правилах и товарных фидах. Если курс обновляется вручную, назначьте ответственного и периодичность проверки: устаревшее значение напрямую влияет на цену, которую видит покупатель. Автоматическое обновление включайте только после проверки источника курса и результата на тестовом заказе.

Для контроля в рабочем магазине периодически сравнивайте одну и ту же тестовую цену в карточке товара, корзине и заказе. Если вы обновляете OpenCart или меняете тему, повторите эту проверку: интерфейс и поведение расширений могут отличаться между версиями.

Курс валюты — числовое значение, которое OpenCart использует для пересчёта цены из основной валюты в выбранную. Ошибка в курсе меняет отображаемые суммы, даже если код валюты и символ указаны правильно.