Валюты и деньги
Два правила определяют всё остальное на этой странице, и оба — решения, а не детали реализации.
Суммы везде целые в минорных единицах
В денежном пути нет ни одного числа с точкой. 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 и забывший добавить её способу своего шлюза, наберёт заказов, которые не сможет получить.
В момент оплаты порядок валюты разбирается строго: неизвестная валюта даёт ошибку, а не догадку в два знака. Цену на карточке форматируют с догадкой, сумму шлюзу — нет.
Шлюзам сумма уезжает в том виде, который хочет каждый: кто-то берёт минорные единицы, кто-то десятичную строку с точкой. Этот перевод — одна функция, а не привычка, повторённая в десяти драйверах.