Multi Currency for WooCommerce

Multi Currency for WooCommerce — покупатель видит цены магазина в своей валюте по курсу НБУ, а заказ и платёж всегда идут в одной валюте: подмена суммы или валюты на этапе оплаты невозможна в принципе.

Заказ и платёж — всегда одна валюта

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

Переключатель и определение валюты

Шорткод [catcode_currency_switcher] вставляется в меню, шапку или футер и выводится списком или выпадающим списком. Валюта покупателя запоминается на месяц. Pro-версия дополнительно предлагает валюту сразу по стране посетителя — выбор покупателя всегда имеет приоритет над автоопределением.

Отчёты WooCommerce остаются корректными

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

Зачем это магазину

Украинский магазин, который продаёт за границу, сталкивается с простой вещью: покупатель из Польши или Германии видит цену в гривне и не понимает, дорого это или нет. Он не пойдёт считать курс — он уйдёт с сайта. Показ цены в привычной ему валюте убирает этот шаг.

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

Откуда берётся курс

Курс тянется из НБУ и обновляется автоматически дважды в сутки. Это официальный курс, а не биржевой — тот самый, по которому считает бухгалтерия, поэтому отчёты сходятся.

В Pro курс можно задать вручную или добавить наценку к курсу НБУ — это то, что обычно и делают магазины, чтобы покрыть комиссию эквайринга и колебания за сутки.

Что получает админ

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

Настраивается округление: сколько знаков после запятой (от 0 до 4) показывать для каждой валюты.

Совместимость с кешем

Типичный провал валютных модулей — кеш. Страница, сгенерированная для покупателя в евро, отдаётся следующему посетителю, и тот видит чужую валюту.

Модуль добавляет валюту в vary-ключ кеша, поэтому каждая валюта кешируется отдельно. Кеш при этом остаётся включённым — не приходится выключать его ради мультивалютности.

Что под капотом

Валюта и курс заказа хранятся в мета-полях самого заказа. Это и есть причина, почему платёж и отчётность сходятся: любой модуль, который потом читает заказ, видит ту же пару «сумма + валюта», что и покупатель на чекауте.

Курс кешируется, поэтому НБУ дёргается дважды в сутки, а не на каждую загрузку страницы. Если API не ответил — модуль работает на последнем известном курсе и не показывает покупателю пустую цену.

Как установить

1. Загрузите архив в «Плагины → Добавить новый → Загрузить плагин» и активируйте.

2. В настройках включите нужные валюты и нажмите обновление курса.

3. Поставьте переключатель шорткодом туда, где он нужен — обычно в шапку.

4. Оформите тестовый заказ в неосновной валюте и проверьте, что платёжка получила ту же сумму и валюту.

5. Если стоит кеш — прогрейте страницы в обеих валютах и убедитесь, что они не перепутались.