Skip to content

Валюты и деньги ​

Два правила определяют всё остальное на этой странице, и оба — решения, а не детали реализации.

Суммы везде целые в минорных единицах ​

В денежном пути нет ни одного числа с точкой. 18,50 € хранится как 1850. Цены, итоги, скидки, доставка и возвраты — целые, а Support\Money — единственное место, где происходит перевод в человеческий вид и обратно.

Поэтому скидка 33% на одну копейку равна нулю, а не 0,33, и поэтому итог не уезжает на копейку после трёх сложений.

Цены фиксированы на валюту и по курсу не считаются ​

У товара нет «цены» плюс курса. У него есть цена в каждой валюте, в которой вы продаёте, вписанная руками.

Почему не по курсу

Потому что «18 €», пересчитанное из рублей, — это «18,18 €», и так не ставит цену никто. Курс превращает каждую цену каталога в неудобное число, которое меняется за спиной владельца, а магазин с ежедневно плавающими ценами выглядит сломанным, а не отзывчивым.

Колонка rate у валюты существует и применяется для пересчёта суммы там, где он действительно нужен: отчётность, итоги по разным валютам. Цены товаров через него не идут никогда.

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

Справочник валют ​

pb_shop_currencies, грид Валюты:

ПолеЧто в нём
codeкод ISO — EUR, UAH, MDL
nameназвание
symbolсимвол — €, ₴. Пусто — печатается код
exponentзнаков в минорной единице; 2 у большинства, 0 у иены
rateсколько базовой валюты стоит одна её единица
is_defaultумолчание витрины. Ровно одна
published_atневыложенная валюта в переключателе не предлагается

И символ, и порядок читаются из этой таблицы, поэтому валюта, которой никто не предвидел, заводится строкой. У пяти распространённых есть встроенные значения на случай, если таблице сказать нечего, — EUR, USD, RUB, MDL, UAH, — но таблица побеждает всюду, где у неё есть запись.

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

В какой валюте открывается магазин ​

По порядку: выбор покупателя, потом pbshop_currency, потом строка с is_default, потом EUR как последний ответ. pbshop_currencies перечисляет те, что предлагают.

Как вписывают цены ​

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

У варианта может быть своя цена на валюту тем же порядком. Там, где её нет, действует цена товара.

Суммы вписывают в обычном десятичном виде и переводят в минорные единицы при сохранении: 1850 вместо 18,50 € печатать не надо.

Переключатель валюты ​

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

Выбор живёт в cookie, а не в сессии, — и это вопрос кеша

Кеш ответов PageBlocks считает ключ по адресу и по зарегистрированным гостевым cookie, а не по состоянию сессии. Валюта, лежащая в сессии, означала бы, что цены одного гостя раздаются из кеша другому; в cookie страница в EUR кешируется отдельно от той же страницы в USD.

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

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

Валюты и способы оплаты ​

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

В сиде украинские шлюзы привязаны к UAH, maib — к MDL, EUR и USD, а у Stripe и PayPal валюты не заданы вовсе: эти двое работают с десятками, и список зависит от договора, а не от шлюза.

Если текущую валюту не принимает ни один способ, платить нечем

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

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

Шлюзам сумма уезжает в том виде, который хочет каждый: кто-то берёт минорные единицы, кто-то десятичную строку с точкой. Этот перевод — одна функция, а не привычка, повторённая в десяти драйверах.

Дальше ​

  • Оплата — привязка валют к способам
  • Промокоды — почему фиксированная скидка задаётся на валюту

pbShop — магазин для сайтов на PageBlocks