Пересчёт цен в другую валюту при выборе способа оплаты

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

Что настраивается

• Основная валюта сайта и валюта пересчёта — трёхбуквенными кодами; символ валюты пересчёта задаётся отдельно и подставляется вместо основного.
• Платёжная система — ключ системы или часть её названия в корзине. Пока выбрана она, цены показываются в валюте пересчёта.
• Курс — автоматический или свой.
• Наценка к курсу в процентах — та самая надбавка, которую обычно просят владельцы магазинов, чтобы покрыть разницу с курсом эквайринга.
• Округление — до копеек, целых, десятков или сотен.
• Пересчёт живёт, пока открыта корзина. Когда покупатель её закрывает, способ оплаты возвращается к исходному, а цены и валюта — к основным. Так корзина не может «застыть» в другой валюте: товар, добавленный после закрытия, всегда попадает в неё по обычной цене.

Коды и символы популярных валют

Источник курса понимает 160 с лишним валют, так что список не ограничен этой десяткой — код любой валюты по ISO 4217 подойдёт.

По какому курсу идёт пересчёт

Автоматический курс берётся из открытого источника open.er-api.com (данные сервиса exchangerate-api.com), запрашивается один раз в сутки и кешируется в браузере покупателя.

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

Что учтено

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

Что уходит в платёжную систему

При включённой настройке «Пересчитывать сам заказ» в заказ уходит ровно та сумма, которую видит покупатель: модификация меняет цены и итог в объекте корзины Тильды, а не только подписи на экране.

Из этого следует главное условие: выбранная платёжная система должна быть настроена в Тильде на ту же валюту, в которую идёт пересчёт. Иначе покупатель увидит 12 $ и заплатит 12 — но рублей, потому что валюту списания задаёт не страница, а настройки платёжной системы.

Пересчитывать сам заказ можно только для товаров, у которых цена задана прямо в блоке. Для товаров из каталога Тильда сверяет цену с базой магазина всегда, отключить это нельзя, и такой заказ будет отклонён с сообщением «У товара изменилась цена». Для каталога оставляйте пересчёт только на экране.

Важные оговорки по корзине

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