diff --git a/README.md b/README.md
index f97c43f..76e7ebb 100644
--- a/README.md
+++ b/README.md
@@ -1,93 +1,169 @@
-# PHPShop
+# 🌟 Платёжный модуль «Монета» для [PHPShop](https://www.phpshop.ru/)
+
+
+
+> **© Правообладатель:** НКО «МОНЕТА» (ООО)
-## Getting started
+> **📦 Версия модуля: 2.0**
-To make it easy for you to get started with GitLab, here's a list of recommended next steps.
+> ℹ️ Модуль заменяет встроенный в PHPShop 6.7 и 7.0 модуль «Монета» 1.0: тот же каталог `moneta` и тот же способ оплаты, настройки переносятся кнопкой «Обновить модуль» (раздел [«Обновление со встроенного модуля»](#обновление-со-встроенного-модуля)).
-Already a pro? Just edit this README.md and make it your own. Want to make it easy? [Use the template at the bottom](#editing-this-readme)!
+> **ℹ️ Требования:**
+> **PHPShop:** 6.7.0+
+> **PHP:** 7.4+
+> **Валюта магазина:** только RUB
-## Add your files
+## 🚀 Установка и настройка модуля
-* [Create](https://docs.gitlab.com/user/project/repository/web_editor/#create-a-file) or [upload](https://docs.gitlab.com/user/project/repository/web_editor/#upload-a-file) files
-* [Add files using the command line](https://docs.gitlab.com/topics/git/add_files/#add-files-to-a-git-repository) or push an existing Git repository with the following command:
+1. 📥 [Скачайте архив модуля](https://git.pub.moneta.ru/CMS/PHPShop/releases).
+2. Распакуйте архив в каталог `phpshop/modules/` магазина — в корне архива лежит каталог `moneta`, он заменит файлы встроенного модуля «Монета». Загрузить архив через админку PHPShop нельзя: в ней нет установки модулей из архива. Два способа:
+ - **файловый менеджер панели хостинга** (ISPmanager, cPanel, Plesk и др.): загрузите архив в `phpshop/modules/` и распакуйте его там, соглашаясь на замену файлов, затем удалите архив и распакованный рядом `README.md` (это эта инструкция, модулю он не нужен);
+ - **FTP/SFTP**: распакуйте архив на своём компьютере и скопируйте каталог `moneta` в `phpshop/modules/` с заменой файлов.
-```
-cd existing_repo
-git remote add origin https://git.moneta.ru:8000/products/cashier/cms/PHPShop.git
-git branch -M main
-git push -uf origin main
+ В итоге должен получиться путь `phpshop/modules/moneta/install/module.xml` — без лишнего вложенного каталога. Если встроенный модуль «Монета» у вас включён, сначала прочитайте раздел [«Обновление со встроенного модуля»](#обновление-со-встроенного-модуля).
+3. Админка PHPShop -> **«Модули»** -> **«Монета»** -> **«Включить»**.
+4. Откройте настройки модуля и заполните поля (таблица ниже), нажмите **«Применить»**.
+5. Включите способ оплаты **«Приём платежей банковскими картами, через СБП и Pay-сервисы (Монета)»**: **«Заказы»** -> **«Способы оплаты»** (`/phpshop/admpanel/admin.php?path=payment`). При установке он встаёт первым в списке способов оплаты при оформлении заказа; порядок меняется полем **«Приоритет»** в карточке способа оплаты (меньшее число — выше).
+6. Настройте счёт в личном кабинете MONETA.RU (раздел ниже).
+
+> **Выключение модуля в PHPShop удаляет его таблицы** — настройки придётся ввести заново.
+
+### Магазин с базой в UTF-8
+
+Если в `phpshop/inc/config.ini` указано `charset = "utf8"`, переключите кодировку статических файлов в `.htaccess` в корне сайта — PHPShop поставляет его с кодировкой windows-1251, а строка для UTF-8 в нём уже есть, но закомментирована:
+
+```apache
+#AddDefaultCharset windows-1251
+AddDefaultCharset utf-8
```
-## Integrate with your tools
+Без этого браузер читает файлы локали PHPShop (`phpshop/locale/russian_utf/*.js`) в неверной кодировке: подсказки и сообщения админки и витрины (например, «Пожалуйста, выберите доставку») выводятся кракозябрами. На nginx то же самое задаёт директива `charset utf-8;` в блоке `server` сайта. После изменения обновите страницы с очисткой кэша браузера (Ctrl+F5). Модуль от этой настройки не зависит: его страницы и данные для MONETA.RU выводятся в нужной кодировке сами.
-* [Set up project integrations](https://git.moneta.ru:8000/products/cashier/cms/PHPShop/-/settings/integrations)
+## Обновление со встроенного модуля
-## Collaborate with your team
+В PHPShop 6.7 и 7.0 модуль «Монета» 1.0 уже встроен — в том же каталоге `phpshop/modules/moneta`. Если он у вас включён, не выключайте его: при выключении PHPShop удаляет таблицы модуля, и номер счёта с кодом пришлось бы вводить заново. Обновление переносит настройки само.
-* [Invite team members and collaborators](https://docs.gitlab.com/user/project/members/)
-* [Create a new merge request](https://docs.gitlab.com/user/project/merge_requests/creating_merge_requests/)
-* [Automatically close issues from merge requests](https://docs.gitlab.com/user/project/issues/managing_issues/#closing-issues-automatically)
-* [Enable merge request approvals](https://docs.gitlab.com/user/project/merge_requests/approvals/)
-* [Set auto-merge](https://docs.gitlab.com/user/project/merge_requests/auto_merge/)
+**Перед обновлением**
-## Test and Deploy
+- Обновляйте, когда нет оплат «в процессе»: оплату, которую покупатель начал во встроенном модуле, а MONETA.RU подтвердила уже после обновления, новый модуль не узнает и не зачтёт — такие заказы после обновления сверьте с операциями в личном кабинете MONETA.RU и отметьте оплаченными вручную.
+- Если вы правили шаблоны в каталоге модуля (`templates/`), сохраните их копию — файлы будут заменены.
-Use the built-in continuous integration in GitLab.
+**Обновление**
-* [Get started with GitLab CI/CD](https://docs.gitlab.com/ci/quick_start/)
-* [Analyze your code for known vulnerabilities with Static Application Security Testing (SAST)](https://docs.gitlab.com/user/application_security/sast/)
-* [Deploy to Kubernetes, Amazon EC2, or Amazon ECS using Auto Deploy](https://docs.gitlab.com/topics/autodevops/requirements/)
-* [Use pull-based deployments for improved Kubernetes management](https://docs.gitlab.com/user/clusters/agent/)
-* [Set up protected environments](https://docs.gitlab.com/ci/environments/protected_environments/)
+1. Распакуйте архив модуля в `phpshop/modules/` с заменой файлов встроенного модуля — как в шаге 2 [установки](#-установка-и-настройка-модуля). Модуль не выключайте.
+2. Админка PHPShop -> **«Модули»** -> **«Монета»**. На вкладке «Основное» появится предупреждение, что настройки ещё от встроенного модуля, — до нажатия кнопки из шага 3 приём оплат выключен (покупатель видит «Оплата через Монету временно недоступна»), а изменения на этой вкладке не сохраняются.
+3. Вкладка **«О модуле»**: PHPShop пишет «Версия ядра 2.0 не соответствует версии базы данных 1.2» — нажмите **«Обновить модуль»**.
+4. Проверьте настройки на вкладке «Основное» и нажмите **«Применить»**:
+ - **Номер счёта** перенесён из поля «ID» встроенного модуля (только цифры), **код проверки целостности данных** — из поля «Секретное слово», **«Оплата при статусе»** и **«Описание оплаты»** — как было;
+ - **Сервер платежей** — «Боевой», как работал встроенный модуль; для демо-счёта выберите «Демо»;
+ - **Тестовый режим** и **фискализация** — выключены: включите их, если они нужны (см. [«Настройки модуля»](#настройки-модуля)).
+5. Способ оплаты остаётся прежним, включённым или выключенным, как был. Его название и иконка заменяются на новые, если вы их не меняли; изменённые сохраняются.
-***
+**Личный кабинет MONETA.RU** — настройки счёта (раздел [«Настройка счёта в личном кабинете MONETA.RU»](#настройка-счёта-в-личном-кабинете-monetaru)):
-# Editing this README
+| Поле | Было у встроенного модуля | Что указать |
+|-------------------------------|----------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Check URL** | пусто | `https://<ваш-сайт>/phpshop/modules/moneta/payment/callback.php` — модуль проверит заказ до оплаты: сумму, статус, не оплачен ли он уже |
+| **Pay URL** | `https://<ваш-сайт>/phpshop/modules/moneta/payment/result.php` | `…/payment/callback.php`, как Check URL. Старый адрес `result.php` тоже работает, менять его можно не сразу |
+| **Success URL**, **Fail URL** | `http://<ваш-сайт>/success` и `/fail` | Лучше включить флаг **«Можно переопределять настройки в URL»**: модуль сам вернёт покупателя на страницу со статусом оплаты. Без флага укажите адреса **со слэшем на конце** — `https://<ваш-сайт>/success/` и `https://<ваш-сайт>/fail/`: адреса без слэша PHPShop не открывает (404), так было и со встроенным модулем |
-When you're ready to make this README your own, just edit this file and use the handy template below (or feel free to structure it however you want - this is just a starting point!). Thanks to [makeareadme.com](https://www.makeareadme.com/) for this template.
+## Настройки модуля
-## Suggestions for a good README
+| Поле | Описание |
+|-------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Номер счёта** | Номер расширенного счёта [MONETA.RU](https://moneta.ru/), только цифры |
+| **Код проверки целостности данных** | Код проверки целостности данных, указанный в настройках расширенного счёта. Сохранённый код в настройках не показывается — оставьте поле пустым, чтобы его не менять |
+| **Сервер платежей** | `Боевой` (по умолчанию) / `Демо` (demo.moneta.ru, отдельный номер счёта) |
+| **Тестовый режим** | По умолчанию `Выкл`. Передаёт `MNT_TEST_MODE=1`; должен совпадать с флагом «Тестовый режим» в настройках счёта |
+| **URL для уведомлений** | Скопируйте и укажите этот адрес в настройках расширенного счёта как Check URL и Pay URL |
+| **Описание оплаты** | Текст над суммой и кнопкой оплаты на странице «Заказ оформлен» и в личном кабинете покупателя. По умолчанию `Оплатите пожалуйста свой заказ`, пусто — без текста. Пока заказ ждёт проверки менеджером, текст не показывается: покупатель видит «Заказ обрабатывается менеджером.» |
+| **Фискализация чеков** | По умолчанию `Выкл`. Фискализация чеков по 54-ФЗ средствами системы MONETA.RU сервисом kassa.payanyway.ru |
+| **Email для чеков** | Обязателен при включённой фискализации: если у покупателя нет ни email, ни телефона, чек уйдёт на этот адрес |
+| **Система налогообложения** | По умолчанию `Не передавать` — касса возьмёт её из своих настроек |
+| **НДС на товары** | `Из настроек раздела «Настройка цен»` (по умолчанию) — «Значение НДС» в разделе «Настройка цен» системных настроек PHPShop; иначе одна ставка на все товары, включая расчётные 5/105 … 22/122 |
+| **НДС на доставку** | `Из настроек способа доставки` (по умолчанию) — «Значение НДС» способа доставки; иначе одна ставка на доставку |
+| **Признак способа расчёта** | У всех позиций чека, включая доставку. По умолчанию `Полный расчёт` |
+| **Признак предмета расчёта** | У товаров. По умолчанию `Товар`; для услуг, работ и др. — по перечню кассы. Доставка в чеке всегда «Услуга» |
+| **Оплата при статусе** | `Новый заказ` — оплата сразу после оформления; другой статус — после проверки заказа менеджером |
+| **Статус после оплаты** | По умолчанию `Оплачено платежными системами` |
-Every project is different, so consider which of these sections apply to yours. The sections used in the template are suggestions for most open source projects. Also keep in mind that while a README can be too long and detailed, too long is better than too short. If you think your README is too long, consider utilizing another form of documentation rather than cutting out information.
+Сохранять настройки может только администратор с правом «Модули: редактирование» (раздел «Администраторы», вкладка «Права»). Модуль принимает сохранение только со страницы настроек этого же магазина. Если вместо сохранения появилось «запрос пришёл не со страницы этого магазина», откройте настройки заново и нажмите «Применить». Если сообщение повторяется, проверьте, не убирает ли браузер, расширение или прокси заголовки Origin и Referer.
-## Name
-Choose a self-explaining name for your project.
+## Оформление блока оплаты
-## Description
-Let people know what your project can do specifically. Provide context and add a link to any reference visitors might be unfamiliar with. A list of Features or a Background subsection can also be added here. If there are alternatives to your project, this is a good place to list differentiating factors.
+На странице «Заказ оформлен» покупатель видит карточку оплаты: логотип MONETA.RU, описание оплаты из настроек, сумму «К оплате», кнопку «Оплатить <сумма>» и пояснение о переходе на защищённую страницу MONETA.RU. Карточка собирается по шаблону `phpshop/modules/moneta/templates/payment_forma.tpl`, стили — `templates/moneta.css`, логотип — `templates/moneta.svg`; их можно изменить под тему магазина:
-## Badges
-On some READMEs, you may see small images that convey metadata, such as whether or not all the tests are passing for the project. You can use Shields to add some to your README. Many services also have instructions for adding a badge.
+| Переменная | Что подставляется |
+|-----------------------|---------------------------------------------------------------------------------------------------|
+| `@payment_info@` | «Описание оплаты» из настроек модуля — обычный текст, переносы строк сохраняются |
+| `@payment_info_hide@` | `moneta-hide`, если описание пустое или заказ сейчас нельзя оплатить |
+| `@moneta_total@` | Сумма к оплате, как её пишет витрина: `18 500` и знак рубля темы (`p`) |
+| `@moneta_total_hide@` | `moneta-hide`, если заказ сейчас нельзя оплатить, — скрывает сумму и пояснение |
+| `@payment_forma@` | Форма с кнопкой «Оплатить» или текст о состоянии заказа |
-## Visuals
-Depending on what you are making, it can be a good idea to include screenshots or even a video (you'll frequently see GIFs rather than actual videos). Tools like ttygif can help, but check out Asciinema for a more sophisticated method.
+Переменные `@payment_info@` и `@payment_forma@` — те же, что во встроенном модуле PHPShop, поэтому шаблон от него подойдёт. Пути к файлам модуля в шаблоне пишутся без начального слэша (`phpshop/modules/...`) — витрина PHPShop сама делает их абсолютными. Шаблон и стили лежат в каталоге модуля: **обновление модуля их перезапишет** — сохраните свою версию перед обновлением.
-## Installation
-Within a particular ecosystem, there may be a common way of installing things, such as using Yarn, NuGet, or Homebrew. However, consider the possibility that whoever is reading your README is a novice and would like more guidance. Listing specific steps helps remove ambiguity and gets people to using your project as quickly as possible. If it only runs in a specific context like a particular programming language version or operating system or has dependencies that have to be installed manually, also add a Requirements subsection.
+## 🔧 Настройка счёта в личном кабинете MONETA.RU
-## Usage
-Use examples liberally, and show the expected output if you can. It's helpful to have inline the smallest example of usage that you can demonstrate, while providing links to more sophisticated examples if they are too long to reasonably include in the README.
+1. 📝 [Зарегистрируйтесь](https://payanyway.ru/partnerRegistration.htm) в платёжной системе PayAnyWay и заполните все
+ необходимые данные. Дождитесь проверки аккаунта и создайте **расширенный счет**.
-## Support
-Tell people where they can go to for help. It can be any combination of an issue tracker, a chat room, an email address, etc.
+2. ⚙️ Заполните настройки расширенного счета (раздел **«Мой счет» → «Управление счетами» → «Редактировать счет» →
+ «Показать дополнительные поля»**):
-## Roadmap
-If you have ideas for releases in the future, it is a good idea to list them in the README.
+| Параметр | Значение |
+|------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| **Псевдоним** | любой, например `Монета` |
+| **Тестовый режим** | `Нет` (как в настройке модуля) |
+| **Check URL** и **Pay URL** | `https://<ваш-сайт>/phpshop/modules/moneta/payment/callback.php` — готовый адрес — в поле «URL для уведомлений» настроек модуля (кнопка «Копировать») и на вкладке «Инструкция» |
+| **HTTP метод (PayUrl, CheckUrl)** | `POST` или `GET` |
+| **Код проверки целостности данных** | произвольный набор символов; тот же код укажите в настройках модуля |
+| **Подпись формы оплаты обязательна** | `Да` |
+| **Можно переопределять настройки в url** | `Да` |
+| **Success URL** | Оставить пустым |
+| **Fail URL** | Оставить пустым |
+| **InProgress URL** | Оставить пустым |
+| **Return URL** | Оставить пустым |
-## Contributing
-State if you are open to contributions and what your requirements are for accepting them.
+> ⚠️ **Важно!** Для кириллического домена PayURL и CheckURL должны быть указаны в
+> кодировке [Punycode](https://2ip.ru/punycode/).
-For people who want to make changes to your project, it's helpful to have some documentation on how to get started. Perhaps there is a script that they should run or some environment variables that they need to set. Make these steps explicit. These instructions could also be useful to your future self.
+3. Для фискализации чеков по 54-ФЗ средствами за рамками PHPShop настройте вашу кассу в сервисе kassa.payanyway.ru,
+ в настройках расширенного счёта в MONETA.RU установите Pay URL https://kassa.payanyway.ru/index.php?do=invoicepayurl,
+ а в настройках кассы пропишите Pay URL вашего интернет-магазина `https://<ваш-сайт>/phpshop/modules/moneta/payment/callback.php`.
+ В этом случае чек по 54-ФЗ будет пробиваться через kassa.payanyway.ru, а запрос на Pay URL магазина будет проходить через этот сервис транзитом.
-You can also document commands to lint the code or run tests. These steps help to ensure high code quality and reduce the likelihood that the changes inadvertently break something. Having instructions for running tests is especially helpful if it requires external setup, such as starting a Selenium server for testing in a browser.
+## Журнал операций
-## Authors and acknowledgment
-Show your appreciation to those who have contributed to the project.
+**«Модули»** -> **«Монета»** -> **«Журнал операций»**: каждое уведомление MONETA.RU (проверка заказа и оплата) с ответом модуля. Код проверки целостности и подписи в журнал не пишутся.
-## License
-For open source projects, say how it is licensed.
+На странице — 500 последних записей, по ним работают поиск и сортировка таблицы. Записи одного заказа за всё время находит поле над таблицей: введите номер заказа (`33-57`) или целиком `MNT_TRANSACTION_ID` из личного кабинета MONETA.RU.
-## Project status
-If you have run out of energy or time for your project, put a note at the top of the README saying that development has slowed down or stopped completely. Someone may choose to fork your project or volunteer to step in as a maintainer or owner, allowing your project to keep going. You can also make an explicit request for maintainers.
+На что обратить внимание:
+
+- **«Вторая оплата оплаченного заказа»** — покупатель оплатил заказ дважды. Модуль вторую оплату не зачитывает, MONETA.RU будет повторять уведомление; сделайте возврат в личном кабинете MONETA.RU или свяжитесь с покупателем.
+- **«Сумма не совпадает с заказом»**, **«У заказа другой способ оплаты»** — заказ изменили после того, как покупатель открыл форму оплаты. Верните сумму или способ оплаты — повторное уведомление MONETA.RU зачтёт оплату.
+- **«Чек не собран»** — при включённой фискализации модуль не смог собрать чек заказа, и оплата не началась: без чека касса не пробьёт его по 54-ФЗ. Причина — в журнале ошибок PHP (строки с префиксом `moneta:`); обычно это сумма заказа выше предела кассы (42 949 672,95 ₽) или сбой базы данных.
+- **«Тестовый режим не совпадает с настройкой модуля»** — флаг «Тестовый режим» в модуле и в настройках счёта MONETA.RU должен совпадать.
+
+## Как проходит оплата
+
+1. После оформления заказа (или в личном кабинете, если оплата доступна после проверки менеджером) покупатель нажимает кнопку оплаты и переходит на платёжную форму MONETA.RU.
+2. MONETA.RU проверяет заказ (Check URL) и после оплаты уведомляет магазин (Pay URL) — модуль переводит заказ в статус «после оплаты».
+3. Покупатель возвращается в магазин на страницу `/moneta/`. Если MONETA.RU уже подтвердила оплату — «Оплата прошла успешно»; если подтверждение ещё в пути — страница около минуты ждёт его и обновляется сама. Статус заказа виден только его владельцу: вошедшему покупателю или в том же браузере, где показывалась кнопка оплаты; остальным — «Заказ не найден». Статус заказа меняет только уведомление MONETA.RU, а не возврат покупателя. Шаблон страницы — `templates/return_forma.tpl`, стили — `templates/moneta.css`.
+
+## 📚 Полезные ресурсы
+
+* [PHPShop](https://www.phpshop.ru/)
+* [PHP API](https://wiki.phpshop.ru/api/php-api)
+* [HTML Верстальщику](https://wiki.phpshop.ru/dizain/verstalshiku)
+* [Прайс-листы поставщиков в CSV](https://wiki.phpshop.ru/rabota-s-bazoi/import-i-eksport/csv)
+* [Ручное добавление каталогов, товаров](https://wiki.phpshop.ru/tovary/ruchnoe-dobavlenie-tovarov)
+* [Установка на хостинг](https://wiki.phpshop.ru/ustanovka-i-obnovlenie/ustanovka-na-khosting#ustanovka-cherez-arhiv-v-ruchnom-rezhime)
+* [Разработчикам](https://wiki.phpshop.ru/moduli/razrabotchikam/)
+
+---
+
+**✅ Модуль настроен, приятных платежей!** 💰🎉
diff --git a/moneta/admpanel/adm_module.php b/moneta/admpanel/adm_module.php
new file mode 100644
index 0000000..bad63c9
--- /dev/null
+++ b/moneta/admpanel/adm_module.php
@@ -0,0 +1,525 @@
+getParam('base.moneta.moneta_system'));
+
+/**
+ * : .
+ * , `.modules.edit`
+ * , ({@see SettingsWriteGuard}). ,
+ * .
+ */
+function monetaSettingsWriteAllowed(): bool
+{
+ global $PHPShopBase;
+
+ $reason = SettingsWriteGuard::denialReason(
+ (bool) $PHPShopBase->Rule->CheckedRules('modules', 'edit'),
+ $_SERVER,
+ );
+ if ($reason === null) {
+ return true;
+ }
+
+ $reasons = [
+ SettingsWriteGuard::DENIED_RIGHTS => ' : ',
+ SettingsWriteGuard::DENIED_METHOD => ' POST ( )',
+ SettingsWriteGuard::DENIED_ORIGIN => ' (Origin/Referer)',
+ ];
+ (new ErrorLogLogger())->error(' : ' . ($reasons[$reason] ?? $reason) . '.');
+ if (isset($_REQUEST['ajax'])) {
+ exit(json_encode(['success' => false]));
+ }
+ if ($reason === SettingsWriteGuard::DENIED_RIGHTS) {
+ $PHPShopBase->Rule->BadUserFormaWindow();
+ } else {
+ echo '' . HostCharset::toPage(
+ ' : . '
+ . ' .',
+ ) . '
';
+ }
+
+ return false;
+}
+
+/**
+ * : SQL updates/< >/ module.xml.
+ */
+function actionBaseUpdate()
+{
+ global $PHPShopModules, $PHPShopOrm;
+
+ if (!monetaSettingsWriteAllowed()) {
+ return true;
+ }
+
+ $PHPShopOrm->clean();
+ $option = $PHPShopOrm->select();
+ $newVersion = $PHPShopModules->getUpdate($option['version']);
+ $PHPShopOrm->clean();
+ $action = $PHPShopOrm->update(['version_new' => $newVersion]);
+ header('Location: ?path=modules&id=' . urlencode((string) $_GET['id']));
+
+ return $action;
+}
+
+function actionUpdate()
+{
+ global $PHPShopOrm, $PHPShopModules;
+
+ if (!monetaSettingsWriteAllowed()) {
+ return true;
+ }
+
+ // . ,
+ // 1.0: account_id,
+ // integrity_code ( updates/1.2/update_module.sql). UPDATE
+ // , .
+ // ; (actionStart()).
+ // : SELECT .
+ // clean() ORM select(), actionBaseUpdate().
+ $PHPShopOrm->clean();
+ $row = $PHPShopOrm->select();
+ if (!is_array($row) || SettingsRepository::needsUpgrade($row)) {
+ header('Location: ?path=modules&id=' . urlencode((string) $_GET['id']));
+
+ return false;
+ }
+ $PHPShopOrm->clean();
+
+ // , .
+ $PHPShopModules->updateOption($_GET['id'], $_POST['servers'] ?? null);
+
+ $post = static function (string $name): string {
+ $value = $_POST[$name] ?? '';
+
+ return is_string($value) ? trim($value) : '';
+ };
+
+ $update = [
+ 'payment_server_new' => PaymentServer::fromSetting($post('payment_server_new'))->getValue(),
+ 'test_mode_new' => $post('test_mode_new') === '1' ? '1' : '0',
+ 'title_end_new' => strip_tags($post('title_end_new')),
+ 'fiscalization_new' => $post('fiscalization_new') === '1' ? '1' : '0',
+ 'sno_new' => TaxSystem::fromSetting($post('sno_new'))->getValue(),
+ 'payment_method_new' => PaymentMethod::fromSetting($post('payment_method_new'))->getValue(),
+ 'payment_object_new' => PaymentObject::fromSetting($post('payment_object_new'))->getValue(),
+ 'goods_vat_new' => VatSetting::fromSetting($post('goods_vat_new'))->getValue(),
+ 'delivery_vat_new' => VatSetting::fromSetting($post('delivery_vat_new'))->getValue(),
+ 'status_new' => (int) $post('status_new'),
+ 'paid_status_new' => (int) $post('paid_status_new') > 0
+ ? (int) $post('paid_status_new')
+ : Settings::STATUS_PAID_BY_GATEWAY,
+ ];
+
+ $receiptEmail = $post('receipt_email_new');
+ $update['receipt_email_new'] = strlen($receiptEmail) <= 64
+ && filter_var($receiptEmail, FILTER_VALIDATE_EMAIL) !== false
+ ? $receiptEmail
+ : '';
+
+ $accountId = preg_replace('/[^0-9]/', '', $post('account_id_new')) ?? '';
+ if ($accountId !== '') {
+ $update['account_id_new'] = $accountId;
+ }
+
+ $integrityCode = $post('integrity_code_new');
+ if ($integrityCode !== '') {
+ $update['integrity_code_new'] = $integrityCode;
+ }
+
+ // Email : ,
+ // actionStart().
+ if ($update['fiscalization_new'] === '1' && $update['receipt_email_new'] === '') {
+ $update['fiscalization_new'] = ((string) ($row['fiscalization'] ?? '0') === '1') ? '1' : '0';
+ }
+
+ $PHPShopOrm->debug = false;
+ $action = $PHPShopOrm->update($update);
+ header('Location: ?path=modules&id=' . urlencode((string) $_GET['id']));
+
+ return $action;
+}
+
+function actionStart()
+{
+ global $PHPShopGUI, $PHPShopOrm;
+
+ PHPShopObj::loadClass('order');
+
+ $data = $PHPShopOrm->select();
+ $statuses = (new PHPShopOrderStatusArray())->getArray();
+ $statuses = is_array($statuses) ? $statuses : [];
+
+ $settings = Settings::fromRow(is_array($data) ? $data : []);
+ $context = new ShopContext();
+
+ // utf-8 ,
+ // __() ( , , ). setAlert(..., false), setSelect()
+ // .
+ // ( ) .
+ $page = static function (string $text): string {
+ return HostCharset::toPage($text);
+ };
+
+ $Tab1 = '';
+ $needsUpgrade = is_array($data) && SettingsRepository::needsUpgrade($data);
+ // :
+ // , .
+ $requiredText = $needsUpgrade ? 'text' : 'text.required';
+ if ($needsUpgrade) {
+ $Tab1 .= $PHPShopGUI->setAlert(
+ HostCharset::toPage(
+ ' , . '
+ . ' - . '
+ . ' , .',
+ ),
+ 'warning',
+ false,
+ );
+ }
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setInput($requiredText, 'account_id_new', $settings->getAccountId(), false, 300)
+ . $PHPShopGUI->setHelp(' '),
+ );
+
+ // HTML : (actionUpdate()).
+ // : setInput() autocomplete, new-password
+ // .
+ $hasIntegrityCode = is_array($data) && (string) ($data['integrity_code'] ?? '') !== '';
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ ''
+ . $PHPShopGUI->setHelp(
+ ' , '
+ . ($hasIntegrityCode ? '. , ' : ''),
+ ),
+ );
+
+ $servers = [
+ [HostCharset::toPage(''), PaymentServer::PROD, $settings->getPaymentServer()->getValue()],
+ [HostCharset::toPage(''), PaymentServer::DEMO, $settings->getPaymentServer()->getValue()],
+ ];
+ $Tab1 .= $PHPShopGUI->setField(' ', $PHPShopGUI->setSelect('payment_server_new', $servers, 300));
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setCheckbox('test_mode_new', '1', '', $settings->isTestMode() ? 1 : 0)
+ . $PHPShopGUI->setHelp(' '),
+ );
+
+ // , : navigator.clipboard HTTPS localhost,
+ // HTTP- execCommand('copy').
+ $callbackUrl = htmlspecialchars($context->callbackUrl(), ENT_QUOTES, 'Windows-1251');
+ $Tab1 .= $PHPShopGUI->setField(
+ 'URL ',
+ HostCharset::toPage(
+ ''
+ . ''
+ . '
',
+ )
+ . $PHPShopGUI->setHelp(
+ ' Check URL Pay URL',
+ ),
+ );
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setTextarea(
+ 'title_end_new',
+ htmlspecialchars($settings->getPaymentDescription(), ENT_QUOTES, 'Windows-1251'),
+ false,
+ 300,
+ 80,
+ )
+ . $PHPShopGUI->setHelp(
+ ' . ',
+ ),
+ );
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setCheckbox('fiscalization_new', '1', '', $settings->isFiscalization() ? 1 : 0)
+ . $PHPShopGUI->setHelp(' 54- kassa.payanyway.ru'),
+ );
+
+ // ;
+ // .
+ $fiscal = 'moneta-fiscal';
+
+ if ($settings->isFiscalization() && $settings->getReceiptEmail() === '') {
+ $Tab1 .= $PHPShopGUI->setAlert(
+ HostCharset::toPage(
+ ' , Email . : ,'
+ . ' email, .',
+ ),
+ 'warning',
+ false,
+ );
+ }
+
+ $Tab1 .= $PHPShopGUI->setField(
+ 'Email ',
+ $PHPShopGUI->setInput(
+ 'email',
+ 'receipt_email_new',
+ htmlspecialchars($settings->getReceiptEmail(), ENT_QUOTES, 'Windows-1251'),
+ false,
+ 300,
+ )
+ . $PHPShopGUI->setHelp(
+ ' , email, , ',
+ ),
+ 1,
+ null,
+ $fiscal,
+ );
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setSelect(
+ 'sno_new',
+ SelectOptions::fromLabels(array_map($page, TaxSystem::LABELS), $settings->getTaxSystem()->getValue()),
+ 300,
+ )
+ . $PHPShopGUI->setHelp(' , '),
+ 1,
+ null,
+ $fiscal,
+ );
+
+ // PHPShop ( , 23):
+ // ѻ, PHP.
+ $vatWarnings = [];
+ try {
+ $vatRates = new HostVatRates(Database::fromHost());
+ $vatWarnings = VatRateWarnings::find(
+ $settings->isFiscalization(),
+ $vatRates->isEnabled(),
+ $settings->getGoodsVat(),
+ $settings->getDeliveryVat(),
+ $vatRates->systemPercent(),
+ $vatRates->enabledDeliveries(),
+ );
+ } catch (\Throwable $exception) {
+ (new ErrorLogLogger())->error(' PHPShop : ' . $exception->getMessage());
+ }
+ if ($vatWarnings !== []) {
+ $escape = static function (string $text): string {
+ return htmlspecialchars($text, ENT_QUOTES, 'Windows-1251');
+ };
+ $Tab1 .= $PHPShopGUI->setAlert(
+ HostCharset::toPage(
+ ' ѻ: '
+ . implode('; ', array_map($escape, $vatWarnings))
+ . '. ѻ '
+ . ' .',
+ ),
+ 'warning',
+ false,
+ );
+ }
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setSelect(
+ 'goods_vat_new',
+ SelectOptions::fromLabels(
+ array_map($page, VatSetting::labels(' ')),
+ $settings->getGoodsVat()->getValue(),
+ ),
+ 300,
+ )
+ . $PHPShopGUI->setHelp(' ѻ '),
+ 1,
+ null,
+ $fiscal,
+ );
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setSelect(
+ 'delivery_vat_new',
+ SelectOptions::fromLabels(
+ array_map($page, VatSetting::labels(' ')),
+ $settings->getDeliveryVat()->getValue(),
+ ),
+ 300,
+ )
+ . $PHPShopGUI->setHelp(' ѻ .'),
+ 1,
+ null,
+ $fiscal,
+ );
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setSelect(
+ 'payment_method_new',
+ SelectOptions::fromLabels(array_map($page, PaymentMethod::LABELS), $settings->getPaymentMethod()->getValue()),
+ 300,
+ )
+ . $PHPShopGUI->setHelp(' , '),
+ 1,
+ null,
+ $fiscal,
+ );
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setSelect(
+ 'payment_object_new',
+ SelectOptions::fromLabels(array_map($page, PaymentObject::LABELS), $settings->getPaymentObject()->getValue()),
+ 300,
+ )
+ . $PHPShopGUI->setHelp(' ; '),
+ 1,
+ null,
+ $fiscal,
+ );
+
+ // email ,
+ // (
+ // actionUpdate()); Email .
+ $Tab1 .= '';
+
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setSelect(
+ 'status_new',
+ OrderStatusOptions::build($statuses, $settings->getPayableStatus(), $page(' '), Settings::STATUS_NEW),
+ 300,
+ ),
+ );
+ $Tab1 .= $PHPShopGUI->setField(
+ ' ',
+ $PHPShopGUI->setSelect(
+ 'paid_status_new',
+ OrderStatusOptions::build(
+ $statuses,
+ $settings->getPaidStatus(),
+ $page(' '),
+ Settings::STATUS_PAID_BY_GATEWAY,
+ ),
+ 300,
+ ),
+ );
+
+ // cp1251: . ,
+ // setInfo(): UTF-8- __() strip_tags .
+ $link = static function (string $url, string $text): string {
+ return '' . $text . '';
+ };
+ $kassa = $link('https://kassa.payanyway.ru/', 'kassa.payanyway.ru');
+
+ $accountRows = [
+ ['', ', ' . $callbackUrl . ''],
+ ['HTTP- (Check URL, Pay URL)', 'POST GET'],
+ [
+ ' ',
+ ' ; ',
+ ],
+ [' ', '| ' . $field . ' | ' . $value . ' |
';
+ }
+
+ $info = ' ' . $link('https://moneta.ru/', 'MONETA.RU') . '
+
+ - ' . $link('https://payanyway.ru/partnerRegistration.htm', '') . '
+ PayAnyWay .
+ .
+ - : ->
+ -> -> .
+
+ | | |
|---|
+ ' . $accountTable . '
+
+
+ - .
+ - demo.moneta.ru .
+ - 54- PHPShop
+ ' . $kassa . ', MONETA.RU Pay URL
+
https://kassa.payanyway.ru/index.php?do=invoicepayurl,
+ Pay URL - ' . '' . $callbackUrl . '' . '. 54-
+ ' . $kassa . ', Pay URL
+ .
+
+ ! Check URL Pay URL
+ ' . $link('https://2ip.ru/punycode/', 'Punycode') . '.
+
+ PHPShop : .
';
+ $Tab2 = '' . HostCharset::toPage($info) . '
' . $block->getInfo() . '
';
+
+ return HostCharset::toPage('' . $info . $block->getForm() . '
');
+ }
+
+ /**
+ * : , ,
+ * .
+ *
+ * @param string $formHtml ; {@see PaymentEligibility::PAYABLE}
+ * @param string $total ;
+ * @param string $description ; :
+ * ( )
+ */
+ public static function compose(
+ string $eligibility,
+ string $formHtml,
+ string $total = '',
+ string $description = ''
+ ): CheckoutBlock {
+ if ($eligibility === PaymentEligibility::PAYABLE) {
+ return new CheckoutBlock($formHtml, $total, self::descriptionHtml($description));
+ }
+
+ return new CheckoutBlock('' . (self::MESSAGES[$eligibility] ?? self::UNAVAILABLE) . '
');
+ }
+
+ private function block(int $orderId, bool $afterCheckout): CheckoutBlock
+ {
+ try {
+ $settings = $this->settingsRepository->load();
+ $order = $this->orderRepository->findById($orderId);
+ if ($order === null) {
+ return new CheckoutBlock('');
+ }
+ // uid,
+ // (`users.core/action_order_info.php` ): .
+ if (!$afterCheckout && !ReturnAccess::isOwner($order, $this->shopContext->sessionUserId())) {
+ return new CheckoutBlock('');
+ }
+
+ $currency = $this->shopContext->orderCurrency();
+ $eligibility = PaymentEligibility::check($settings, $order, $currency);
+ if ($eligibility !== PaymentEligibility::PAYABLE) {
+ return self::compose($eligibility, '');
+ }
+ $this->shopContext->rememberPayableOrder($order->getId());
+
+ // ,
+ // ; .
+ $amount = '';
+ $currencyIcon = '';
+ if ($afterCheckout) {
+ $amount = AmountText::format($order->getAmount(), $this->shopContext->priceDecimals());
+ $currencyIcon = $this->shopContext->currencyIcon();
+ }
+ $suffix = ($currencyIcon === '') ? '' : ' ' . $currencyIcon;
+ $formHtml = $this->form(
+ $settings,
+ $order,
+ (string) AssistantProtocol::normalizeCurrency($currency),
+ ($amount === '') ? self::BUTTON_TITLE : self::BUTTON_TITLE . ' ' . $amount,
+ ($amount === '') ? '' : $suffix,
+ );
+ $total = ($amount === '') ? '' : $amount . $suffix;
+ $description = HostCharset::fromDatabase($settings->getPaymentDescription());
+
+ return self::compose($eligibility, $formHtml, $total, $description);
+ } catch (\Throwable $exception) {
+ (new ErrorLogLogger())->error(
+ ' ' . $orderId . ' : ' . $exception->getMessage(),
+ );
+
+ return new CheckoutBlock('' . self::UNAVAILABLE . '
');
+ }
+ }
+
+ /**
+ * HTML: , `
`.
+ */
+ private static function descriptionHtml(string $text): string
+ {
+ $text = trim($text);
+
+ return ($text === '') ? '' : nl2br(htmlspecialchars($text, ENT_QUOTES, 'Windows-1251'), false);
+ }
+
+ private function form(
+ Settings $settings,
+ Order $order,
+ string $currency,
+ string $buttonTitle,
+ string $buttonSuffixHtml
+ ): string {
+ return PaymentForm::create(
+ $settings,
+ $order,
+ $currency,
+ $this->shopContext->now(),
+ new ReturnUrls($this->shopContext->returnPageUrl()),
+ ' ' . $order->getUid(),
+ $this->shopContext->cms(),
+ AssistantProtocol::normalizeLocale($this->shopContext->shopLocale()),
+ )->toHtml($buttonTitle, $buttonSuffixHtml);
+ }
+}
diff --git a/moneta/class/host/Database.php b/moneta/class/host/Database.php
new file mode 100644
index 0000000..1276fd8
--- /dev/null
+++ b/moneta/class/host/Database.php
@@ -0,0 +1,131 @@
+link_db`).
+ *
+ * `PHPShopOrm` SQL ,
+ * , . {@see RuntimeException}
+ * MySQL (1062 ) `mysqli_report()`: PHP 7.4
+ * mysqli , 8.1 .
+ */
+final class Database
+{
+ /** . */
+ public const ER_DUP_ENTRY = 1062;
+
+ /** @var mysqli */
+ private $link;
+
+ public function __construct(mysqli $link)
+ {
+ $this->link = $link;
+ }
+
+ public static function fromHost(): self
+ {
+ // $PHPShopBase, $link_db.
+ $base = $GLOBALS['PHPShopBase'] ?? null;
+ $link = is_object($base) && isset($base->link_db) ? $base->link_db : ($GLOBALS['link_db'] ?? null);
+ if (!$link instanceof mysqli) {
+ throw new RuntimeException(' PHPShop .');
+ }
+
+ return new self($link);
+ }
+
+ /**
+ * @param array $params
+ *
+ * @return array>
+ */
+ public function fetchAll(string $sql, array $params = []): array
+ {
+ $statement = $this->run($sql, $params);
+ try {
+ $result = $statement->get_result();
+ if ($result === false) {
+ throw new RuntimeException(' : ' . $statement->error, $statement->errno);
+ }
+ $rows = [];
+ while (is_array($row = $result->fetch_assoc())) {
+ $rows[] = $row;
+ }
+
+ return $rows;
+ } finally {
+ $statement->close();
+ }
+ }
+
+ /**
+ * @param array $params
+ *
+ * @return mixed null
+ */
+ public function fetchValue(string $sql, array $params = [])
+ {
+ $rows = $this->fetchAll($sql, $params);
+ if ($rows === []) {
+ return null;
+ }
+
+ return reset($rows[0]);
+ }
+
+ /**
+ * @param array $params
+ *
+ * @return int
+ */
+ public function execute(string $sql, array $params = []): int
+ {
+ $statement = $this->run($sql, $params);
+ $affected = $statement->affected_rows;
+ $statement->close();
+
+ return (int) $affected;
+ }
+
+ /**
+ * @param array $params
+ */
+ private function run(string $sql, array $params): mysqli_stmt
+ {
+ try {
+ $statement = $this->link->prepare($sql);
+ if ($statement === false) {
+ throw new RuntimeException(' : ' . $this->link->error, $this->link->errno);
+ }
+ if ($params !== []) {
+ $types = '';
+ foreach ($params as $param) {
+ $types .= is_int($param) ? 'i' : 's';
+ }
+ $statement->bind_param($types, ...$params);
+ }
+ if (!$statement->execute()) {
+ $error = new RuntimeException(' : ' . $statement->error, $statement->errno);
+ $statement->close();
+
+ throw $error;
+ }
+
+ return $statement;
+ } catch (mysqli_sql_exception $exception) {
+ throw new RuntimeException(
+ ' MySQL: ' . $exception->getMessage(),
+ (int) $exception->getCode(),
+ $exception,
+ );
+ }
+ }
+}
diff --git a/moneta/class/host/ErrorLogLogger.php b/moneta/class/host/ErrorLogLogger.php
new file mode 100644
index 0000000..e38810c
--- /dev/null
+++ b/moneta/class/host/ErrorLogLogger.php
@@ -0,0 +1,19 @@
+codBase`) UTF-8
+ * UTF-8 , .
+ * , (JSON, XML), UTF-8.
+ */
+final class HostCharset
+{
+ private function __construct() {}
+
+ public static function isUtf8Shop(): bool
+ {
+ $base = $GLOBALS['PHPShopBase'] ?? null;
+
+ return is_object($base) && isset($base->codBase) && ($base->codBase === 'utf-8');
+ }
+
+ /**
+ * -> cp1251.
+ */
+ public static function fromDatabase(string $value): string
+ {
+ if (!self::isUtf8Shop()) {
+ return $value;
+ }
+ $converted = iconv('UTF-8', 'Windows-1251//IGNORE', $value);
+
+ return ($converted === false) ? '' : $converted;
+ }
+
+ /**
+ * (cp1251) -> .
+ */
+ public static function toDatabase(string $value): string
+ {
+ return self::isUtf8Shop() ? self::toUtf8($value) : $value;
+ }
+
+ /**
+ * HTML (cp1251) -> .
+ */
+ public static function toPage(string $html): string
+ {
+ return self::isUtf8Shop() ? self::toUtf8($html) : $html;
+ }
+
+ /**
+ * cp1251 -> UTF-8 . 0x98 cp1251 iconv false
+ * ( ), .
+ * //IGNORE: iconv (glibc , musl ).
+ */
+ public static function toUtf8(string $value): string
+ {
+ $converted = iconv('Windows-1251', 'UTF-8', str_replace("\x98", '', $value));
+
+ return ($converted === false) ? '' : $converted;
+ }
+}
diff --git a/moneta/class/host/HostReceiptSource.php b/moneta/class/host/HostReceiptSource.php
new file mode 100644
index 0000000..227258f
--- /dev/null
+++ b/moneta/class/host/HostReceiptSource.php
@@ -0,0 +1,158 @@
+ */
+ private $receipts = [];
+
+ public function __construct(Settings $settings, Database $database, Logger $logger)
+ {
+ $this->settings = $settings;
+ $this->vatRates = new HostVatRates($database);
+ $this->logger = $logger;
+ }
+
+ public function attributes(Order $order): array
+ {
+ $receipt = $this->receipt($order);
+
+ return ($receipt !== null)
+ ? $receipt->toAttributes($this->settings->isFiscalization(), $this->settings->getTaxSystem())
+ : [];
+ }
+
+ public function jsonReceipt(Order $order): ?array
+ {
+ $receipt = $this->receipt($order);
+
+ return ($receipt !== null) ? $receipt->toJsonReceipt() : null;
+ }
+
+ private function receipt(Order $order): ?Receipt
+ {
+ if (isset($this->receipts[$order->getId()])) {
+ return $this->receipts[$order->getId()];
+ }
+
+ try {
+ $builder = new ReceiptBuilder(
+ Closure::fromCallable([HostCharset::class, 'toUtf8']),
+ $this->settings->getPaymentMethod(),
+ $this->settings->getPaymentObject(),
+ $this->settings->getGoodsVat()->getFixed(),
+ );
+ $receiptEmail = $this->settings->isFiscalization() ? $this->settings->getReceiptEmail() : '';
+ $receipt = $builder->build($order, $this->goodsVat($order), $this->deliveryVat($order), $receiptEmail);
+ } catch (\Throwable $exception) {
+ $this->logger->error(
+ sprintf(
+ ' %s : %s: %s',
+ $order->getUid(),
+ get_class($exception),
+ $exception->getMessage(),
+ ),
+ );
+
+ return null;
+ }
+
+ return $this->receipts[$order->getId()] = $receipt;
+ }
+
+ private function goodsVat(Order $order): Vat
+ {
+ $fixed = $this->settings->getGoodsVat()->getFixed();
+ if ($fixed !== null) {
+ return $fixed;
+ }
+
+ if (!$this->vatRates->isEnabled()) {
+ return Vat::none();
+ }
+
+ return $this->platformVat($order, $this->vatRates->systemPercent(), ' PHPShop ()');
+ }
+
+ private function deliveryVat(Order $order): Vat
+ {
+ $fixed = $this->settings->getDeliveryVat()->getFixed();
+ if ($fixed !== null) {
+ return $fixed;
+ }
+
+ if (!$this->vatRates->isEnabled()) {
+ return Vat::none();
+ }
+
+ $percent = $this->vatRates->deliveryPercent($order->getDeliveryMethodId());
+ if ($percent !== '') {
+ return $this->platformVat($order, $percent, ' ');
+ }
+
+ return $this->platformVat($order, $this->vatRates->systemPercent(), ' PHPShop ()');
+ }
+
+ /**
+ * PHPShop; ѻ , .
+ */
+ private function platformVat(Order $order, string $percent, string $source): Vat
+ {
+ $vat = Vat::tryFromPercent($percent);
+ if ($vat !== null) {
+ return $vat;
+ }
+
+ if ($this->settings->isFiscalization()) {
+ $this->logger->error(
+ sprintf(
+ ' %s: %s %s ѻ.'
+ . ' PHPShop .',
+ $order->getUid(),
+ $source,
+ // , : .
+ VatRateWarnings::shown((string) preg_replace('/[^0-9.,%+\- ]/', '?', substr($percent, 0, 16))),
+ ),
+ );
+ }
+
+ return Vat::none();
+ }
+}
diff --git a/moneta/class/host/HostVatRates.php b/moneta/class/host/HostVatRates.php
new file mode 100644
index 0000000..0023d46
--- /dev/null
+++ b/moneta/class/host/HostVatRates.php
@@ -0,0 +1,93 @@
+database = $database;
+ }
+
+ public function isEnabled(): bool
+ {
+ return !empty(self::systemParam('nds_enabled'));
+ }
+
+ public function systemPercent(): string
+ {
+ return self::systemParam('nds');
+ }
+
+ /**
+ * ѻ ; .
+ */
+ public function deliveryPercent(int $deliveryId): string
+ {
+ $table = self::deliveryTable();
+ if ($deliveryId <= 0 || $table === null) {
+ return '';
+ }
+
+ return trim((string) $this->database->fetchValue(
+ 'SELECT ofd_nds FROM `' . $table . '` WHERE id = ? LIMIT 1',
+ [$deliveryId],
+ ));
+ }
+
+ /**
+ * ( ): [ cp1251, ѻ].
+ *
+ * @return array
+ */
+ public function enabledDeliveries(): array
+ {
+ $table = self::deliveryTable();
+ if ($table === null) {
+ return [];
+ }
+
+ $deliveries = [];
+ $rows = $this->database->fetchAll(
+ 'SELECT city, ofd_nds FROM `' . $table . "` WHERE enabled = '1' AND (is_folder IS NULL OR is_folder <> '1')"
+ . ' ORDER BY num, id',
+ );
+ foreach ($rows as $row) {
+ $deliveries[] = [
+ HostCharset::fromDatabase((string) ($row['city'] ?? '')),
+ trim((string) ($row['ofd_nds'] ?? '')),
+ ];
+ }
+
+ return $deliveries;
+ }
+
+ private static function deliveryTable(): ?string
+ {
+ $table = $GLOBALS['SysValue']['base']['delivery'] ?? null;
+
+ // SQL: , \w . OperationRepository::table().
+ return (is_string($table) && preg_match('/\A[0-9A-Za-z_]+\z/', $table) === 1) ? $table : null;
+ }
+
+ private static function systemParam(string $name): string
+ {
+ $system = $GLOBALS['PHPShopSystem'] ?? null;
+ if (!is_object($system) || !method_exists($system, 'getParam')) {
+ return '';
+ }
+ $value = $system->getParam($name);
+
+ return is_scalar($value) ? (string) $value : '';
+ }
+}
diff --git a/moneta/class/host/MysqlLogThrottle.php b/moneta/class/host/MysqlLogThrottle.php
new file mode 100644
index 0000000..44af41f
--- /dev/null
+++ b/moneta/class/host/MysqlLogThrottle.php
@@ -0,0 +1,74 @@
+database = $database;
+ }
+
+ public function pass(int $now, int $interval): ?int
+ {
+ $table = self::table();
+
+ // : 1 , 2 ,
+ // 0 . (
+ // ) , .
+ $claimed = $this->database->execute(
+ 'INSERT INTO `' . $table . '` (`id`, `logged_at`, `skipped`) VALUES (' . self::ROW_ID . ', ?, 0)'
+ . ' ON DUPLICATE KEY UPDATE `logged_at` = IF(`logged_at` <= ? OR `logged_at` > ?, ?, `logged_at`)',
+ [$now, $now - $interval, $now, $now],
+ );
+ if ($claimed === 0) {
+ $this->database->execute('UPDATE `' . $table . '` SET `skipped` = `skipped` + 1');
+
+ return null;
+ }
+
+ $skipped = (int) $this->database->fetchValue('SELECT `skipped` FROM `' . $table . '` LIMIT 1');
+ if ($skipped > 0) {
+ $this->database->execute(
+ 'UPDATE `' . $table . '` SET `skipped` = GREATEST(`skipped` - ?, 0)',
+ [$skipped],
+ );
+ }
+
+ return $skipped;
+ }
+
+ public static function table(): string
+ {
+ $table = $GLOBALS['SysValue']['base'][ModuleInfo::PATH]['moneta_log_throttle'] ?? null;
+ // , \w: cp1251- PHPShop \w ( OperationRepository).
+ if (!is_string($table) || preg_match('/\A[0-9A-Za-z_]+\z/', $table) !== 1) {
+ throw new RuntimeException(' .');
+ }
+
+ return $table;
+ }
+}
diff --git a/moneta/class/host/MysqlOrderLock.php b/moneta/class/host/MysqlOrderLock.php
new file mode 100644
index 0000000..b005a29
--- /dev/null
+++ b/moneta/class/host/MysqlOrderLock.php
@@ -0,0 +1,38 @@
+database = $database;
+ }
+
+ public function acquire(int $orderId): bool
+ {
+ return (int) $this->database->fetchValue('SELECT GET_LOCK(' . self::NAME . ', ?)', [$orderId, self::TIMEOUT]) === 1;
+ }
+
+ public function release(int $orderId): void
+ {
+ $this->database->fetchValue('SELECT RELEASE_LOCK(' . self::NAME . ')', [$orderId]);
+ }
+}
diff --git a/moneta/class/host/OperationRepository.php b/moneta/class/host/OperationRepository.php
new file mode 100644
index 0000000..a3837ed
--- /dev/null
+++ b/moneta/class/host/OperationRepository.php
@@ -0,0 +1,133 @@
+database = $database;
+ }
+
+ public function findPaidOperation(int $orderId): ?string
+ {
+ $value = $this->database->fetchValue(
+ 'SELECT operation_id FROM `' . self::table() . '` WHERE paid_order_id = ? LIMIT 1',
+ [$orderId],
+ );
+
+ return $value === null ? null : (string) $value;
+ }
+
+ public function recordPaid(CallbackNotification $notification, Order $order, string $event): bool
+ {
+ try {
+ $this->insert($notification, $order, $event, ResultCode::paid(), $order->getId());
+ } catch (RuntimeException $exception) {
+ if ($exception->getCode() === Database::ER_DUP_ENTRY) {
+ return false;
+ }
+
+ throw $exception;
+ }
+
+ return true;
+ }
+
+ public function note(
+ CallbackNotification $notification,
+ ?Order $order,
+ string $event,
+ ?ResultCode $resultCode
+ ): void {
+ $this->insert($notification, $order, $event, $resultCode, null);
+ }
+
+ /**
+ * , .
+ *
+ * @param string|null $orderUid ({@see TransactionId::orderUidFromInput()}):
+ * `order_uid` `MNT_TRANSACTION_ID` `<>_`
+ *
+ * @return array>
+ */
+ public function latest(int $limit, ?string $orderUid = null): array
+ {
+ $where = '';
+ $params = [];
+ if ($orderUid !== null) {
+ // `_` `%` (TransactionId::ORDER_UID) LIKE
+ // `_`.
+ $where = ' WHERE order_uid = ? OR transaction_id LIKE ?';
+ $params = [$orderUid, $orderUid . '\\' . TransactionId::SEPARATOR . '%'];
+ }
+ $params[] = $limit;
+
+ return $this->database->fetchAll(
+ 'SELECT id, created_at, command, transaction_id, operation_id, order_id, order_uid, amount,'
+ . ' test_mode, result_code, event FROM `' . self::table() . '`' . $where . ' ORDER BY id DESC LIMIT ?',
+ $params,
+ );
+ }
+
+ public static function table(): string
+ {
+ $table = $GLOBALS['SysValue']['base'][ModuleInfo::PATH]['moneta_operations'] ?? null;
+ // , \w: /u \w , PHPShop (setlocale
+ // class/base.class.php) cp1251 \w , SQL.
+ if (!is_string($table) || preg_match('/\A[0-9A-Za-z_]+\z/', $table) !== 1) {
+ throw new RuntimeException(' : .');
+ }
+
+ return $table;
+ }
+
+ private function insert(
+ CallbackNotification $notification,
+ ?Order $order,
+ string $event,
+ ?ResultCode $resultCode,
+ ?int $paidOrderId
+ ): void {
+ $amount = $notification->getAmount();
+ $this->database->execute(
+ 'INSERT INTO `' . self::table() . '` (created_at, command, transaction_id, operation_id, order_id,'
+ . ' order_uid, amount, test_mode, result_code, event, paid_order_id) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)',
+ [
+ time(),
+ $notification->isCheck() ? $notification->getCommand() : self::COMMAND_PAY,
+ $notification->getTransactionId(),
+ $notification->getOperationId(),
+ ($order !== null) ? $order->getId() : 0,
+ ($order !== null) ? $order->getUid() : '',
+ ($amount !== null) ? $amount->toDecimal() : '',
+ $notification->getRawTestMode(),
+ ($resultCode !== null) ? $resultCode->getValue() : null,
+ $event,
+ $paidOrderId,
+ ],
+ );
+ }
+}
diff --git a/moneta/class/host/OrderRepository.php b/moneta/class/host/OrderRepository.php
new file mode 100644
index 0000000..4a9806a
--- /dev/null
+++ b/moneta/class/host/OrderRepository.php
@@ -0,0 +1,136 @@
+findOne(['id' => '=' . $id]);
+ }
+
+ public function findByUid(string $uid): ?Order
+ {
+ if (preg_match('/\A' . TransactionId::ORDER_UID . '\z/', $uid) !== 1) {
+ return null;
+ }
+
+ return $this->findOne(['uid' => "='" . $uid . "'"]);
+ }
+
+ /**
+ * : , `changeStatus()` ( ,
+ * , ) `paid`. `ofd()` :
+ * MONETA.
+ */
+ public function markPaid(Order $order, int $paidStatus, Money $amount): void
+ {
+ $database = Database::fromHost();
+ if ($paidStatus === Settings::STATUS_PAID_BY_GATEWAY) {
+ $this->ensurePaidByGatewayStatus($database);
+ }
+ $this->logPayment($database, $order, $amount);
+
+ $orderFunction = new PHPShopOrderFunction($order->getId());
+ $orderFunction->changeStatus($paidStatus, $order->getStatusId());
+ $orderFunction->changePaymentStatus(1);
+ }
+
+ /**
+ * `phpshop_payment`: (`4-36` -> 436),
+ * (`PHPShopOrderFunction::checkPay()`).
+ * ( `setNum`) .
+ */
+ private function logPayment(Database $database, Order $order, Money $amount): void
+ {
+ if (preg_match('/\A([0-9]+)-([0-9]+)\z/', $order->getUid(), $matches) !== 1) {
+ return;
+ }
+ $database->execute(
+ 'INSERT IGNORE INTO `' . self::table('payment') . '` (uid, name, sum, datas) VALUES (?, ?, ?, ?)',
+ [(int) ($matches[1] . $matches[2]), self::PAYMENT_LOG_NAME, $amount->toDecimal(), time()],
+ );
+ }
+
+ private function ensurePaidByGatewayStatus(Database $database): void
+ {
+ $database->execute(
+ 'INSERT IGNORE INTO `' . self::table('order_status') . "` (id, name, color, external_code, bot_message)"
+ . " VALUES (?, ?, '#ccff00', '', '')",
+ [Settings::STATUS_PAID_BY_GATEWAY, HostCharset::toDatabase(self::STATUS_PAID_BY_GATEWAY_NAME)],
+ );
+ }
+
+ private static function table(string $key): string
+ {
+ $table = $GLOBALS['SysValue']['base'][$key] ?? null;
+ // , \w: /u \w , PHPShop (setlocale
+ // class/base.class.php) cp1251 \w , SQL.
+ if (!is_string($table) || preg_match('/\A[0-9A-Za-z_]+\z/', $table) !== 1) {
+ throw new RuntimeException(" {$key} .");
+ }
+
+ return $table;
+ }
+
+ /**
+ * @param array $where
+ */
+ private function findOne(array $where): ?Order
+ {
+ $orm = new PHPShopOrm($GLOBALS['SysValue']['base']['orders']);
+ $orm->debug = false;
+ $row = $orm->select(['*'], $where, false, ['limit' => 1]);
+ if (!is_array($row) || empty($row['id'])) {
+ return null;
+ }
+
+ $details = @unserialize((string) ($row['orders'] ?? ''), ['allowed_classes' => false]);
+ if (!is_array($details)) {
+ $details = [];
+ }
+ foreach (['fio', 'tel'] as $field) {
+ if (isset($row[$field]) && is_string($row[$field])) {
+ $row[$field] = HostCharset::fromDatabase($row[$field]);
+ }
+ }
+ // , .
+ if (isset($details['Cart']['cart']) && is_array($details['Cart']['cart'])) {
+ foreach ($details['Cart']['cart'] as $key => $product) {
+ if (is_array($product) && isset($product['name']) && is_string($product['name'])) {
+ $details['Cart']['cart'][$key]['name'] = HostCharset::fromDatabase($product['name']);
+ }
+ }
+ }
+
+ return Order::fromRow($row, $details);
+ }
+}
diff --git a/moneta/class/host/SettingsRepository.php b/moneta/class/host/SettingsRepository.php
new file mode 100644
index 0000000..0cf9e23
--- /dev/null
+++ b/moneta/class/host/SettingsRepository.php
@@ -0,0 +1,49 @@
+debug = false;
+ $row = $orm->select(['*'], false, false, ['limit' => 1]);
+ if (!is_array($row)) {
+ throw new RuntimeException(' .');
+ }
+
+ return Settings::fromRow($row);
+ }
+
+ /**
+ * PHPShop: ,
+ * ( `updates/1.2/`) .
+ *
+ * @param array $row
+ */
+ public static function needsUpgrade(array $row): bool
+ {
+ return !array_key_exists('account_id', $row);
+ }
+
+ public static function table(): string
+ {
+ $table = $GLOBALS['SysValue']['base'][ModuleInfo::PATH]['moneta_system'] ?? null;
+ if (!is_string($table) || ($table === '')) {
+ throw new RuntimeException(' : .');
+ }
+
+ return $table;
+ }
+}
diff --git a/moneta/class/host/ShopContext.php b/moneta/class/host/ShopContext.php
new file mode 100644
index 0000000..9ebb6c3
--- /dev/null
+++ b/moneta/class/host/ShopContext.php
@@ -0,0 +1,171 @@
+isHttps() ? 'https://' : 'http://') . $host . $this->basePath();
+ }
+
+ public function returnPageUrl(): string
+ {
+ return $this->baseUrl() . self::RETURN_PAGE;
+ }
+
+ /**
+ * , `Location` `/success`
+ * `/fail`. `SERVER_NAME` Apache `Host` ,
+ * .
+ */
+ public function returnPagePath(): string
+ {
+ return $this->basePath() . self::RETURN_PAGE;
+ }
+
+ public function callbackUrl(): string
+ {
+ return $this->baseUrl() . self::CALLBACK_PATH;
+ }
+
+ /**
+ * ISO- ().
+ */
+ public function orderCurrency(): string
+ {
+ $system = $GLOBALS['PHPShopSystem'] ?? null;
+ if (!is_object($system) || !method_exists($system, 'getDefaultValutaIso')) {
+ return '';
+ }
+
+ return (string) $system->getDefaultValutaIso(true);
+ }
+
+ /**
+ * : (`PHPShopElements`).
+ */
+ public function shopLocale(): string
+ {
+ $locale = $_SESSION['lang'] ?? '';
+
+ return is_string($locale) ? $locale : '';
+ }
+
+ /**
+ * , :
+ * , ({@see ReturnAccess}).
+ */
+ public function rememberPayableOrder(int $orderId): void
+ {
+ if (session_status() !== PHP_SESSION_ACTIVE) {
+ return;
+ }
+ $_SESSION[ReturnAccess::SESSION_KEY] = ReturnAccess::remember(
+ $_SESSION[ReturnAccess::SESSION_KEY] ?? null,
+ $orderId,
+ );
+ }
+
+ /**
+ * ID (`$_SESSION['UsersId']`); 0 .
+ */
+ public function sessionUserId(): int
+ {
+ return (int) ($_SESSION['UsersId'] ?? 0);
+ }
+
+ /**
+ * (`admoption.price_znak`).
+ */
+ public function priceDecimals(): int
+ {
+ $system = $GLOBALS['PHPShopSystem'] ?? null;
+ if (!is_object($system) || !method_exists($system, 'getSerilizeParam')) {
+ return 0;
+ }
+
+ return (int) $system->getSerilizeParam('admoption.price_znak');
+ }
+
+ /**
+ * , :
+ * `p` p ;
+ * . HTML , cp1251.
+ */
+ public function currencyIcon(): string
+ {
+ $system = $GLOBALS['PHPShopSystem'] ?? null;
+ if (!is_object($system) || !method_exists($system, 'getValutaIcon')) {
+ return '';
+ }
+
+ return HostCharset::fromDatabase(trim((string) $system->getValutaIcon(true)));
+ }
+
+ /**
+ * `MNT_CMS`: PHPShop `[upload] version` (`670`).
+ */
+ public function cms(): string
+ {
+ $uploadVersion = (string) ($GLOBALS['SysValue']['upload']['version'] ?? '');
+
+ return CmsInfo::format(CmsInfo::hostVersion($uploadVersion), PHP_VERSION, ModuleInfo::VERSION);
+ }
+
+ /**
+ * . (`PHPShopSystem::setTimeZone()`),
+ * PHP ;
+ * `MNT_TRANSACTION_ID` , UTC.
+ */
+ public function now(): DateTimeImmutable
+ {
+ return new DateTimeImmutable('now');
+ }
+
+ /**
+ * PHPShop (`[dir] dir` `inc/config.ini`), .
+ */
+ private function basePath(): string
+ {
+ return rtrim((string) ($GLOBALS['SysValue']['dir']['dir'] ?? ''), '/');
+ }
+
+ private function isHttps(): bool
+ {
+ $https = strtolower((string) ($_SERVER['HTTPS'] ?? ''));
+ if (($https !== '') && ($https !== 'off')) {
+ return true;
+ }
+
+ return strtolower((string) ($_SERVER['HTTP_X_FORWARDED_PROTO'] ?? '')) === 'https';
+ }
+}
diff --git a/moneta/class/order/Order.php b/moneta/class/order/Order.php
new file mode 100644
index 0000000..94777d8
--- /dev/null
+++ b/moneta/class/order/Order.php
@@ -0,0 +1,194 @@
+`
+ * (`PHPShopDone::send_to_order()`) .
+ */
+ private const GUEST_EMAIL_PREFIX = 'guest@';
+
+ /** @var int */
+ private $id;
+
+ /** @var string */
+ private $uid;
+
+ /** @var Money */
+ private $amount;
+
+ /** @var int */
+ private $statusId;
+
+ /** @var bool */
+ private $paid;
+
+ /** @var int */
+ private $paymentMethodId;
+
+ /** @var string */
+ private $email;
+
+ /** @var string */
+ private $phone;
+
+ /** @var string */
+ private $customerName;
+
+ /** @var int */
+ private $userId;
+
+ /** @var array */
+ private $cart;
+
+ /** @var float */
+ private $discountPercent;
+
+ /** @var int */
+ private $deliveryMethodId;
+
+ private function __construct() {}
+
+ /**
+ * @param array $row `phpshop_orders`
+ * @param array $details `orders`: `['Cart' => ..., 'Person' => ...]`
+ */
+ public static function fromRow(array $row, array $details): self
+ {
+ $id = (int) ($row['id'] ?? 0);
+ $uid = (string) ($row['uid'] ?? '');
+ if (($id <= 0) || ($uid === '')) {
+ throw new InvalidArgumentException(' id uid.');
+ }
+
+ $person = isset($details['Person']) && is_array($details['Person']) ? $details['Person'] : [];
+ $cart = isset($details['Cart']) && is_array($details['Cart']) ? $details['Cart'] : [];
+
+ $order = new self();
+ $order->id = $id;
+ $order->uid = $uid;
+ $order->amount = Money::fromFloat((float) ($row['sum'] ?? 0));
+ $order->statusId = (int) ($row['statusi'] ?? 0);
+ $order->paid = (int) ($row['paid'] ?? 0) === 1;
+ $order->paymentMethodId = (int) ($person['order_metod'] ?? 0);
+ $order->email = self::email((string) ($person['mail'] ?? ''));
+ $order->phone = trim((string) ($row['tel'] ?? ''));
+ $order->customerName = trim((string) ($row['fio'] ?? ''));
+ $order->userId = (int) ($row['user'] ?? 0);
+ $order->cart = $cart;
+ $order->discountPercent = (float) ($person['discount'] ?? 0);
+ $order->deliveryMethodId = (int) ($person['dostavka_metod'] ?? 0);
+
+ return $order;
+ }
+
+ public function getId(): int
+ {
+ return $this->id;
+ }
+
+ /**
+ * , (`4-36`).
+ */
+ public function getUid(): string
+ {
+ return $this->uid;
+ }
+
+ /**
+ * (`phpshop_orders.sum`): , .
+ */
+ public function getAmount(): Money
+ {
+ return $this->amount;
+ }
+
+ public function getStatusId(): int
+ {
+ return $this->statusId;
+ }
+
+ public function isPaidFlag(): bool
+ {
+ return $this->paid;
+ }
+
+ public function getPaymentMethodId(): int
+ {
+ return $this->paymentMethodId;
+ }
+
+ /**
+ * Email ( `guest@...` ).
+ */
+ public function getEmail(): string
+ {
+ return $this->email;
+ }
+
+ public function getPhone(): string
+ {
+ return $this->phone;
+ }
+
+ public function getCustomerName(): string
+ {
+ return $this->customerName;
+ }
+
+ /**
+ * ID PHPShop (`phpshop_shopusers.id`), 0 .
+ */
+ public function getUserId(): int
+ {
+ return $this->userId;
+ }
+
+ /**
+ * (`Cart`: `cart`, `dostavka`, `sum`...) .
+ *
+ * @return array
+ */
+ public function getCart(): array
+ {
+ return $this->cart;
+ }
+
+ /**
+ * (`Person.discount`): ,
+ * -.
+ */
+ public function getDiscountPercent(): float
+ {
+ return $this->discountPercent;
+ }
+
+ /**
+ * (`phpshop_delivery.id`), 0 .
+ */
+ public function getDeliveryMethodId(): int
+ {
+ return $this->deliveryMethodId;
+ }
+
+ private static function email(string $raw): string
+ {
+ $email = trim($raw);
+ if (($email === '') || stripos($email, self::GUEST_EMAIL_PREFIX) === 0) {
+ return '';
+ }
+
+ return (filter_var($email, FILTER_VALIDATE_EMAIL) !== false) ? $email : '';
+ }
+}
diff --git a/moneta/class/order/OrderStatusOptions.php b/moneta/class/order/OrderStatusOptions.php
new file mode 100644
index 0000000..44354c4
--- /dev/null
+++ b/moneta/class/order/OrderStatusOptions.php
@@ -0,0 +1,42 @@
+ $statuses : `id` `name`
+ * @param int $current
+ *
+ * @return array
+ */
+ public static function build(array $statuses, int $current, string $firstLabel, int $firstValue): array
+ {
+ $options = [[$firstLabel, $firstValue, $current]];
+ foreach ($statuses as $status) {
+ if (!is_array($status) || !isset($status['id'], $status['name'])) {
+ continue;
+ }
+
+ $id = (int) $status['id'];
+ if ($id !== $firstValue) {
+ $options[] = [(string) $status['name'], $id, $current];
+ }
+ }
+
+ return $options;
+ }
+}
diff --git a/moneta/class/order/PaymentEligibility.php b/moneta/class/order/PaymentEligibility.php
new file mode 100644
index 0000000..45bdbd7
--- /dev/null
+++ b/moneta/class/order/PaymentEligibility.php
@@ -0,0 +1,76 @@
+isConfigured()) {
+ return self::NOT_CONFIGURED;
+ }
+
+ if ($order->getPaymentMethodId() !== ModuleInfo::PAYMENT_METHOD_ID) {
+ return self::OTHER_PAYMENT_METHOD;
+ }
+
+ if (self::isPaid($settings, $order)) {
+ return self::ALREADY_PAID;
+ }
+
+ if ($order->getStatusId() === self::STATUS_CANCELLED) {
+ return self::CANCELLED;
+ }
+
+ if (!$settings->isPayableRightAfterCheckout() && $order->getStatusId() !== $settings->getPayableStatus()) {
+ return self::AWAITING_STATUS;
+ }
+
+ if (AssistantProtocol::normalizeCurrency($shopCurrency) === null) {
+ return self::UNSUPPORTED_CURRENCY;
+ }
+
+ if (!$order->getAmount()->isPositive()) {
+ return self::ZERO_AMOUNT;
+ }
+
+ return self::PAYABLE;
+ }
+
+ /**
+ * : `paid` .
+ */
+ public static function isPaid(Settings $settings, Order $order): bool
+ {
+ return $order->isPaidFlag() || ($order->getStatusId() === $settings->getPaidStatus());
+ }
+}
diff --git a/moneta/class/protocol/AssistantProtocol.php b/moneta/class/protocol/AssistantProtocol.php
new file mode 100644
index 0000000..8ba79e8
--- /dev/null
+++ b/moneta/class/protocol/AssistantProtocol.php
@@ -0,0 +1,51 @@
+ `MNT_CURRENCY_CODE`; null .
+ * `RUR` , .
+ */
+ public static function normalizeCurrency(string $iso): ?string
+ {
+ $iso = strtoupper(trim($iso));
+
+ return (($iso === self::CURRENCY_RUB) || ($iso === 'RUR')) ? self::CURRENCY_RUB : null;
+ }
+
+ /**
+ * `MNT_TEST_MODE` .
+ */
+ public static function testModeFlag(bool $testMode): string
+ {
+ return $testMode ? '1' : '0';
+ }
+
+ /**
+ * PHPShop (`russian`, `russian_utf`, `english`, `english_utf`) ->
+ * `moneta.locale` . `ru` `en`
+ * (`MONETA.Assistant.ru.pdf`, ): `en`, `ru`.
+ */
+ public static function normalizeLocale(string $shopLocale): string
+ {
+ return strncmp(strtolower(trim($shopLocale)), 'english', 7) === 0 ? 'en' : 'ru';
+ }
+}
diff --git a/moneta/class/protocol/CallbackNotification.php b/moneta/class/protocol/CallbackNotification.php
new file mode 100644
index 0000000..bfd2091
--- /dev/null
+++ b/moneta/class/protocol/CallbackNotification.php
@@ -0,0 +1,183 @@
+ $fields ($_POST $_GET )
+ */
+ public function __construct(array $fields)
+ {
+ $this->command = self::optional($fields, 'MNT_COMMAND', strlen(AssistantProtocol::COMMAND_CHECK));
+ if (($this->command !== '') && ($this->command !== AssistantProtocol::COMMAND_CHECK)) {
+ throw new InvalidArgumentException(' .');
+ }
+
+ $this->accountId = self::required($fields, 'MNT_ID', self::ACCOUNT_ID_MAX_LENGTH);
+ $this->transactionId = self::required($fields, 'MNT_TRANSACTION_ID', self::TRANSACTION_ID_MAX_LENGTH);
+ $this->operationId = self::optional($fields, 'MNT_OPERATION_ID', self::OPERATION_ID_MAX_LENGTH);
+ $this->rawAmount = self::optional($fields, 'MNT_AMOUNT', strlen(Money::MAX));
+ $this->amount = $this->rawAmount === '' ? null : Money::fromDecimal($this->rawAmount);
+ $this->currency = self::required($fields, 'MNT_CURRENCY_CODE', self::CURRENCY_LENGTH);
+ $this->subscriberId = self::optional($fields, 'MNT_SUBSCRIBER_ID', self::SUBSCRIBER_ID_MAX_LENGTH);
+ $this->rawTestMode = self::required($fields, 'MNT_TEST_MODE', 1);
+ if (($this->rawTestMode !== '0') && ($this->rawTestMode !== '1')) {
+ throw new InvalidArgumentException(' MNT_TEST_MODE.');
+ }
+ $this->signature = self::required($fields, 'MNT_SIGNATURE', self::SIGNATURE_LENGTH);
+
+ if (
+ (($this->amount === null) || (preg_match(self::PAY_OPERATION_ID, $this->operationId) !== 1))
+ && !$this->isCheck()
+ ) {
+ throw new InvalidArgumentException(' .');
+ }
+ }
+
+ public function isCheck(): bool
+ {
+ return ($this->command === AssistantProtocol::COMMAND_CHECK);
+ }
+
+ public function getCommand(): string
+ {
+ return $this->command;
+ }
+
+ public function getAccountId(): string
+ {
+ return $this->accountId;
+ }
+
+ public function getTransactionId(): string
+ {
+ return $this->transactionId;
+ }
+
+ public function getOperationId(): string
+ {
+ return $this->operationId;
+ }
+
+ /**
+ * ; {@see self::getAmount()}.
+ */
+ public function getRawAmount(): string
+ {
+ return $this->rawAmount;
+ }
+
+ public function getAmount(): ?Money
+ {
+ return $this->amount;
+ }
+
+ public function getCurrency(): string
+ {
+ return $this->currency;
+ }
+
+ public function getSubscriberId(): string
+ {
+ return $this->subscriberId;
+ }
+
+ public function getRawTestMode(): string
+ {
+ return $this->rawTestMode;
+ }
+
+ public function isTestMode(): bool
+ {
+ return $this->rawTestMode === '1';
+ }
+
+ public function isSignedBy(Signature $signature): bool
+ {
+ return Signature::equals($signature->forNotification($this), $this->signature);
+ }
+
+ /**
+ * @param array $fields
+ */
+ private static function required(array $fields, string $name, int $maxLength): string
+ {
+ $value = self::optional($fields, $name, $maxLength);
+ if ($value === '') {
+ throw new InvalidArgumentException(" {$name}.");
+ }
+
+ return $value;
+ }
+
+ /**
+ * @param array $fields
+ */
+ private static function optional(array $fields, string $name, int $maxLength): string
+ {
+ if (!array_key_exists($name, $fields)) {
+ return '';
+ }
+
+ $value = $fields[$name];
+ if (!is_string($value)) {
+ throw new InvalidArgumentException(" {$name} .");
+ }
+ if (strlen($value) > $maxLength) {
+ throw new InvalidArgumentException(" {$name} .");
+ }
+
+ return $value;
+ }
+}
diff --git a/moneta/class/protocol/CallbackResponse.php b/moneta/class/protocol/CallbackResponse.php
new file mode 100644
index 0000000..8150622
--- /dev/null
+++ b/moneta/class/protocol/CallbackResponse.php
@@ -0,0 +1,55 @@
+contentType = $contentType;
+ $this->body = $body;
+ }
+
+ /**
+ * : .
+ */
+ public static function fail(): self
+ {
+ return new self(self::CONTENT_TYPE_TEXT, AssistantProtocol::TEXT_FAIL);
+ }
+
+ public static function xml(string $body): self
+ {
+ return new self(self::CONTENT_TYPE_XML, $body);
+ }
+
+ public static function json(string $body): self
+ {
+ return new self(self::CONTENT_TYPE_JSON, $body);
+ }
+
+ public function getContentType(): string
+ {
+ return $this->contentType;
+ }
+
+ public function getBody(): string
+ {
+ return $this->body;
+ }
+}
diff --git a/moneta/class/protocol/CheckResponse.php b/moneta/class/protocol/CheckResponse.php
new file mode 100644
index 0000000..748cfc9
--- /dev/null
+++ b/moneta/class/protocol/CheckResponse.php
@@ -0,0 +1,108 @@
+accountId = $accountId;
+ $this->transactionId = $transactionId;
+ $this->amount = $amount;
+ $this->resultCode = $resultCode;
+ $this->signature = $signature;
+ $this->cms = $cms;
+ }
+
+ public function getResultCode(): ResultCode
+ {
+ return $this->resultCode;
+ }
+
+ /**
+ * @param array $attributes `INVENTORY`, `CLIENT`, `CUSTOMER`, `PHONE` Pay URL
+ */
+ public function toXml(array $attributes = []): CallbackResponse
+ {
+ return CallbackResponse::xml(
+ MntResponseXml::build(
+ $this->accountId,
+ $this->transactionId,
+ $this->resultCode,
+ $this->amount,
+ $this->sign(),
+ $this->cms,
+ $attributes,
+ ),
+ );
+ }
+
+ /**
+ * @param array $receipt `receipt` (`client`, `items`);
+ * {@see JsonNumber::placeholder()}, UTF-8
+ */
+ public function toJson(array $receipt): CallbackResponse
+ {
+ $payload = [
+ 'id' => $this->accountId,
+ 'transactionId' => $this->transactionId,
+ ];
+
+ if ($this->amount !== null) {
+ $payload['amount'] = JsonNumber::placeholder($this->amount);
+ }
+
+ $payload += [
+ 'signature' => $this->sign(),
+ 'resultCode' => (string) $this->resultCode->getValue(),
+ 'description' => $this->resultCode->description(),
+ 'cms' => $this->cms,
+ 'receipt' => $receipt,
+ ];
+
+ return CallbackResponse::json(JsonNumber::encode($payload));
+ }
+
+ private function sign(): string
+ {
+ return $this->signature->forResponse($this->resultCode, $this->accountId, $this->transactionId);
+ }
+}
diff --git a/moneta/class/protocol/JsonNumber.php b/moneta/class/protocol/JsonNumber.php
new file mode 100644
index 0000000..edb947e
--- /dev/null
+++ b/moneta/class/protocol/JsonNumber.php
@@ -0,0 +1,65 @@
+toDecimal();
+ }
+
+ /**
+ * : (`2`), , JSON `2.5`.
+ *
+ * @return int|string
+ */
+ public static function quantity(Quantity $quantity)
+ {
+ return $quantity->isWhole() ? $quantity->getPieces() : self::QUANTITY_PREFIX . $quantity->toDecimal();
+ }
+
+ /**
+ * @param array $payload UTF-8
+ */
+ public static function encode(array $payload): string
+ {
+ $json = json_encode($payload, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
+ if ($json === false) {
+ throw new RuntimeException(' JSON: ' . json_last_error_msg());
+ }
+
+ $result = preg_replace(
+ [
+ '/"' . preg_quote(self::PREFIX, '/') . '([0-9]+\.[0-9]{2})"/',
+ '/"' . preg_quote(self::QUANTITY_PREFIX, '/') . '([0-9]+\.[0-9]{1,3})"/',
+ ],
+ '$1',
+ $json,
+ );
+ if ($result === null) {
+ throw new RuntimeException(' JSON.');
+ }
+
+ return $result;
+ }
+}
diff --git a/moneta/class/protocol/MntResponseXml.php b/moneta/class/protocol/MntResponseXml.php
new file mode 100644
index 0000000..f345b23
--- /dev/null
+++ b/moneta/class/protocol/MntResponseXml.php
@@ -0,0 +1,76 @@
+ $attributes KEY -> VALUE `MNT_ATTRIBUTES`, UTF-8
+ * @throws \DOMException
+ */
+ public static function build(
+ string $accountId,
+ string $transactionId,
+ ResultCode $resultCode,
+ ?Money $amount,
+ string $signature,
+ string $cms,
+ array $attributes = []
+ ): string {
+ $document = new DOMDocument('1.0', 'UTF-8');
+
+ $response = $document->appendChild($document->createElement('MNT_RESPONSE'));
+
+ $elements = [
+ 'MNT_ID' => $accountId,
+ 'MNT_TRANSACTION_ID' => $transactionId,
+ 'MNT_RESULT_CODE' => (string) $resultCode->getValue(),
+ 'MNT_DESCRIPTION' => $resultCode->description(),
+ 'MNT_AMOUNT' => $amount !== null ? $amount->toDecimal() : null,
+ 'MNT_SIGNATURE' => $signature,
+ 'MNT_CMS' => $cms,
+ ];
+ foreach ($elements as $name => $value) {
+ if ($value !== null) {
+ self::text($document, $response, $name, $value);
+ }
+ }
+
+ if ($attributes !== []) {
+ $container = $response->appendChild($document->createElement('MNT_ATTRIBUTES'));
+ foreach ($attributes as $key => $value) {
+ $attribute = $container->appendChild($document->createElement('ATTRIBUTE'));
+ self::text($document, $attribute, 'KEY', (string) $key);
+ self::text($document, $attribute, 'VALUE', $value);
+ }
+ }
+
+ $xml = $document->saveXML();
+ if ($xml === false) {
+ throw new RuntimeException(' MNT_RESPONSE.');
+ }
+
+ return $xml;
+ }
+
+ private static function text(DOMDocument $document, DOMNode $parent, string $name, string $value): void
+ {
+ $parent
+ ->appendChild($document->createElement($name))
+ ->appendChild($document->createTextNode($value));
+ }
+}
diff --git a/moneta/class/protocol/PayResponse.php b/moneta/class/protocol/PayResponse.php
new file mode 100644
index 0000000..204ead4
--- /dev/null
+++ b/moneta/class/protocol/PayResponse.php
@@ -0,0 +1,70 @@
+accountId = $accountId;
+ $this->transactionId = $transactionId;
+ $this->amount = $amount;
+ $this->resultCode = $resultCode;
+ $this->signature = $signature;
+ $this->cms = $cms;
+ }
+
+ /**
+ * @param array $attributes `INVENTORY`, `CLIENT`, `CUSTOMER`, `PHONE`
+ * @throws \DOMException
+ */
+ public function toXml(array $attributes = []): CallbackResponse
+ {
+ return CallbackResponse::xml(
+ MntResponseXml::build(
+ $this->accountId,
+ $this->transactionId,
+ $this->resultCode,
+ $this->amount,
+ $this->signature->forResponse($this->resultCode, $this->accountId, $this->transactionId),
+ $this->cms,
+ $attributes,
+ ),
+ );
+ }
+}
diff --git a/moneta/class/protocol/PaymentServer.php b/moneta/class/protocol/PaymentServer.php
new file mode 100644
index 0000000..271179f
--- /dev/null
+++ b/moneta/class/protocol/PaymentServer.php
@@ -0,0 +1,48 @@
+ 'https://www.payanyway.ru/assistant.htm',
+ self::DEMO => 'https://demo.moneta.ru/assistant.htm',
+ ];
+
+ /** @var string */
+ private $value;
+
+ private function __construct(string $value)
+ {
+ $this->value = $value;
+ }
+
+ public static function fromSetting(?string $value): self
+ {
+ return new self(isset(self::URLS[(string) $value]) ? (string) $value : self::PROD);
+ }
+
+ public function getValue(): string
+ {
+ return $this->value;
+ }
+
+ public function isDemo(): bool
+ {
+ return ($this->value === self::DEMO);
+ }
+
+ public function url(): string
+ {
+ return self::URLS[$this->value];
+ }
+}
diff --git a/moneta/class/protocol/ResultCode.php b/moneta/class/protocol/ResultCode.php
new file mode 100644
index 0000000..3a9305e
--- /dev/null
+++ b/moneta/class/protocol/ResultCode.php
@@ -0,0 +1,105 @@
+ 'Order amount',
+ self::PAID => 'Order is paid',
+ self::IN_PROGRESS => 'Order is being processed',
+ self::AWAITING_PAYMENT => 'Order created, but not paid',
+ self::REJECTED => 'Order is not available',
+ ];
+
+ /** @var int */
+ private $value;
+
+ private function __construct(int $value)
+ {
+ $this->value = $value;
+ }
+
+ public static function fromValue(int $value): self
+ {
+ if (!array_key_exists($value, self::DESCRIPTIONS)) {
+ throw new \InvalidArgumentException(' MNT_RESULT_CODE.');
+ }
+
+ return new self($value);
+ }
+
+ public static function withAmount(): self
+ {
+ return new self(self::WITH_AMOUNT);
+ }
+
+ public static function paid(): self
+ {
+ return new self(self::PAID);
+ }
+
+ public static function inProgress(): self
+ {
+ return new self(self::IN_PROGRESS);
+ }
+
+ public static function awaitingPayment(): self
+ {
+ return new self(self::AWAITING_PAYMENT);
+ }
+
+ public static function rejected(): self
+ {
+ return new self(self::REJECTED);
+ }
+
+ public function getValue(): int
+ {
+ return $this->value;
+ }
+
+ public function description(): string
+ {
+ return self::DESCRIPTIONS[$this->value];
+ }
+
+ public function equals(self $other): bool
+ {
+ return ($this->value === $other->value);
+ }
+
+ public function __toString(): string
+ {
+ return (string) $this->value;
+ }
+}
diff --git a/moneta/class/protocol/Signature.php b/moneta/class/protocol/Signature.php
new file mode 100644
index 0000000..7c57c46
--- /dev/null
+++ b/moneta/class/protocol/Signature.php
@@ -0,0 +1,116 @@
+integrityCode = $integrityCode;
+ }
+
+ /**
+ * 1 ( -> ).
+ *
+ * md5(MNT_ID + MNT_TRANSACTION_ID + MNT_AMOUNT + MNT_CURRENCY_CODE + MNT_SUBSCRIBER_ID + MNT_TEST_MODE + )
+ */
+ public function forPaymentForm(
+ string $accountId,
+ string $transactionId,
+ Money $amount,
+ string $currency,
+ string $subscriberId,
+ bool $testMode
+ ): string {
+ return $this->hash(
+ $accountId
+ . $transactionId
+ . $amount->toDecimal()
+ . $currency
+ . $subscriberId
+ . AssistantProtocol::testModeFlag($testMode),
+ );
+ }
+
+ /**
+ * 2 Check URL / Pay URL ( -> ).
+ *
+ * md5(MNT_COMMAND + MNT_ID + MNT_TRANSACTION_ID + MNT_OPERATION_ID + MNT_AMOUNT
+ * + MNT_CURRENCY_CODE + MNT_SUBSCRIBER_ID + MNT_TEST_MODE + )
+ *
+ * : ,
+ * , .
+ */
+ public function forNotification(CallbackNotification $notification): string
+ {
+ return $this->hash(
+ $notification->getCommand()
+ . $notification->getAccountId()
+ . $notification->getTransactionId()
+ . $notification->getOperationId()
+ . $notification->getRawAmount()
+ . $notification->getCurrency()
+ . $notification->getSubscriberId()
+ . $notification->getRawTestMode(),
+ );
+ }
+
+ /**
+ * 3 Check URL Pay URL (XML JSON).
+ *
+ * md5(MNT_RESULT_CODE + MNT_ID + MNT_TRANSACTION_ID + )
+ */
+ public function forResponse(ResultCode $resultCode, string $accountId, string $transactionId): string
+ {
+ return $this->hash((string) $resultCode->getValue() . $accountId . $transactionId);
+ }
+
+ /**
+ * ; hex- .
+ */
+ public static function equals(string $expected, string $received): bool
+ {
+ if (preg_match(self::PATTERN, $received) !== 1) {
+ return false;
+ }
+
+ return hash_equals(strtolower($expected), strtolower($received));
+ }
+
+ /**
+ * var_dump()/print_r() .
+ *
+ * @return array
+ */
+ public function __debugInfo(): array
+ {
+ return ['integrityCode' => '***'];
+ }
+
+ private function hash(string $payload): string
+ {
+ return md5($payload . $this->integrityCode);
+ }
+}
diff --git a/moneta/class/protocol/TransactionId.php b/moneta/class/protocol/TransactionId.php
new file mode 100644
index 0000000..e48f6f9
--- /dev/null
+++ b/moneta/class/protocol/TransactionId.php
@@ -0,0 +1,118 @@
+_<>_UTC`: PHPShop
+ * (`phpshop_orders.uid`, `4-36`), UTC,
+ * `4-36_1600000_20260930113005UTC`.
+ */
+final class TransactionId
+{
+ /**
+ * PHPShop. `<>-<>` (`PHPShopDone::setNum()`),
+ * `setNum` ,
+ * , `phpshop_orders.uid varchar(64)` `_`.
+ */
+ public const ORDER_UID = '[0-9A-Za-z](?:[0-9A-Za-z-]{0,62}[0-9A-Za-z])?';
+
+ public const SEPARATOR = '_';
+
+ /** ; 16 {@see Money::MAX}. */
+ private const AMOUNT = '0|[1-9][0-9]{0,15}';
+
+ /**
+ * UTC, .
+ */
+ private const ZONE = 'UTC';
+
+ private const PATTERN = '/\A
+ (?' . self::ORDER_UID . ') # PHPShop
+ ' . self::SEPARATOR . '
+ (?' . self::AMOUNT . ') #
+ ' . self::SEPARATOR . '
+ [0-9]{14} # YmdHis
+ ' . self::ZONE . ' #
+ \z/x';
+
+ /** @var string */
+ private $orderUid;
+
+ /** @var Money */
+ private $amount;
+
+ private function __construct(string $orderUid, Money $amount)
+ {
+ $this->orderUid = $orderUid;
+ $this->amount = $amount;
+ }
+
+ /**
+ * @param Money $amount (`MNT_AMOUNT`)
+ * @param DateTimeImmutable $issuedAt , UTC
+ */
+ public static function build(string $orderUid, Money $amount, DateTimeImmutable $issuedAt): string
+ {
+ if (preg_match('/\A' . self::ORDER_UID . '\z/', $orderUid) !== 1) {
+ throw new InvalidArgumentException(' MNT_TRANSACTION_ID.');
+ }
+
+ return $orderUid
+ . self::SEPARATOR . $amount->toMinorUnits()
+ . self::SEPARATOR . $issuedAt->setTimezone(new DateTimeZone(self::ZONE))->format('YmdHis') . self::ZONE;
+ }
+
+ /**
+ * `MNT_TRANSACTION_ID` null, .
+ */
+ public static function parse(string $raw): ?self
+ {
+ if (preg_match(self::PATTERN, $raw, $matches) !== 1) {
+ return null;
+ }
+
+ try {
+ $amount = Money::fromMinorUnits((int) $matches['amount']);
+ } catch (InvalidArgumentException $exception) {
+ return null;
+ }
+
+ return new self($matches['uid'], $amount);
+ }
+
+ /**
+ * , ( ): (`33-57`)
+ * `MNT_TRANSACTION_ID`, MONETA.RU. null.
+ */
+ public static function orderUidFromInput(string $input): ?string
+ {
+ $input = trim($input);
+ if (preg_match('/\A' . self::ORDER_UID . '\z/', $input) === 1) {
+ return $input;
+ }
+
+ $transactionId = self::parse($input);
+
+ return ($transactionId === null) ? null : $transactionId->getOrderUid();
+ }
+
+ public function getOrderUid(): string
+ {
+ return $this->orderUid;
+ }
+
+ /**
+ * , .
+ */
+ public function getAmount(): Money
+ {
+ return $this->amount;
+ }
+}
diff --git a/moneta/class/receipt/Measure.php b/moneta/class/receipt/Measure.php
new file mode 100644
index 0000000..65f3e87
--- /dev/null
+++ b/moneta/class/receipt/Measure.php
@@ -0,0 +1,73 @@
+ ( , ). */
+ private const VARIANTS = [
+ self::UNIT => ['', '', '', '', 'pc', 'pce', 'pcs', 'nmb'],
+ 'gram' => ['', '', '', '', 'g', 'grm'],
+ 'kilogram' => ['', '', '', 'kg', 'kgm'],
+ 'ton' => ['', '', '', 't', 'tne'],
+ 'centimeter' => ['', '', 'cm', 'cmt'],
+ 'decimeter' => ['', '', 'dm', 'dmt'],
+ 'meter' => ['', '', '', 'm', 'mtr', '', '.'],
+ 'square_centimeter' => ['', '.', '2', 'cm2', 'cmk'],
+ 'square_decimeter' => ['', '.', '2', 'dm2', 'dmk'],
+ 'square_meter' => ['', '.', '2', 'm2', 'mtk'],
+ 'milliliter' => ['', '', 'ml', 'mlt'],
+ 'liter' => ['', '', '', 'l', 'ltr'],
+ 'cubic_meter' => ['', '.', '3', 'm3', 'mtq'],
+ 'kilowatt_hour' => ['', '*', '-', '', 'kwh'],
+ 'gigacalorie' => ['', '', ''],
+ 'day' => ['', '', '', '', 'd', 'day'],
+ 'hour' => ['', '', 'h', 'hur'],
+ 'minute' => ['', '', 'min'],
+ 'second' => ['', '', '', 's', 'sec'],
+ 'kilobyte' => ['', '', '', 'kib', '', 'kb'],
+ 'megabyte' => ['', '', '', 'mib', '', 'mb'],
+ 'gigabyte' => ['', '', '', 'gib', '', 'gb'],
+ 'terabyte' => ['', '', '', 'tib', '', 'tb'],
+ ];
+
+ private function __construct() {}
+
+ /**
+ * @param string $unit UTF-8
+ * @param Closure(string): string $toUtf8 -> UTF-8
+ */
+ public static function fromUnit(string $unit, Closure $toUtf8): string
+ {
+ // (. ), (.).
+ $unit = rtrim((string) preg_replace('/\s+/u', '', $unit), '.');
+ if ($unit === '') {
+ return self::UNIT;
+ }
+ foreach (self::VARIANTS as $measure => $variants) {
+ foreach ($variants as $variant) {
+ if (preg_match('/\A' . preg_quote($toUtf8($variant), '/') . '\z/iu', $unit) === 1) {
+ return $measure;
+ }
+ }
+ }
+
+ return self::UNIT;
+ }
+}
diff --git a/moneta/class/receipt/PaymentMethod.php b/moneta/class/receipt/PaymentMethod.php
new file mode 100644
index 0000000..bb630d5
--- /dev/null
+++ b/moneta/class/receipt/PaymentMethod.php
@@ -0,0 +1,59 @@
+ , `kassaspecification.pdf`. */
+ public const LABELS = [
+ self::FULL_PREPAYMENT => ' ',
+ self::PREPAYMENT => ' ',
+ self::ADVANCE => '',
+ self::FULL_PAYMENT => ' ',
+ self::PARTIAL_PAYMENT => ' ',
+ self::CREDIT => '',
+ self::CREDIT_PAYMENT => ' ',
+ ];
+
+ /** @var string */
+ private $value;
+
+ private function __construct(string $value)
+ {
+ $this->value = $value;
+ }
+
+ /**
+ * ; ( ).
+ */
+ public static function fromSetting(?string $value): self
+ {
+ return new self(isset(self::LABELS[(string) $value]) ? (string) $value : self::FULL_PAYMENT);
+ }
+
+ public static function fullPayment(): self
+ {
+ return new self(self::FULL_PAYMENT);
+ }
+
+ public function getValue(): string
+ {
+ return $this->value;
+ }
+}
diff --git a/moneta/class/receipt/PaymentObject.php b/moneta/class/receipt/PaymentObject.php
new file mode 100644
index 0000000..c15c141
--- /dev/null
+++ b/moneta/class/receipt/PaymentObject.php
@@ -0,0 +1,71 @@
+ . */
+ public const LABELS = [
+ self::COMMODITY => '',
+ 'excise' => ' ',
+ 'job' => '',
+ self::SERVICE => '',
+ 'gambling_bet' => ' ',
+ 'gambling_prize' => ' ',
+ 'lottery' => ' ',
+ 'lottery_prize' => ' ',
+ 'intellectual_activity' => ' ',
+ 'payment' => '',
+ 'agent_commission' => ' ',
+ 'award' => ' (, , , , )',
+ 'composite' => ' ',
+ 'another' => '',
+ 'property_right' => ' ',
+ 'non_operating' => ' ',
+ 'insurance_premium' => ' ',
+ 'sales_tax' => ' ',
+ 'resort_fee' => ' ',
+ ];
+
+ /** @var string */
+ private $value;
+
+ private function __construct(string $value)
+ {
+ $this->value = $value;
+ }
+
+ /**
+ * ; ( ).
+ */
+ public static function fromSetting(?string $value): self
+ {
+ return new self(isset(self::LABELS[(string) $value]) ? (string) $value : self::COMMODITY);
+ }
+
+ public static function commodity(): self
+ {
+ return new self(self::COMMODITY);
+ }
+
+ public static function service(): self
+ {
+ return new self(self::SERVICE);
+ }
+
+ public function getValue(): string
+ {
+ return $this->value;
+ }
+}
diff --git a/moneta/class/receipt/Quantity.php b/moneta/class/receipt/Quantity.php
new file mode 100644
index 0000000..5178edf
--- /dev/null
+++ b/moneta/class/receipt/Quantity.php
@@ -0,0 +1,111 @@
+ self::MAX_THOUSANDTHS)) {
+ throw new InvalidArgumentException(' .');
+ }
+
+ $this->thousandths = $thousandths;
+ }
+
+ public static function pieces(int $pieces): self
+ {
+ return new self($pieces * self::SCALE);
+ }
+
+ public static function fromThousandths(int $thousandths): self
+ {
+ return new self($thousandths);
+ }
+
+ /**
+ * (`num`): , .
+ * , , null.
+ *
+ * @param mixed $raw
+ */
+ public static function fromCart($raw): ?self
+ {
+ if (is_string($raw)) {
+ $raw = trim($raw);
+ }
+ if (!is_int($raw) && !is_float($raw) && !(is_string($raw) && is_numeric($raw))) {
+ return null;
+ }
+ $thousandths = (int) round((float) $raw * self::SCALE);
+ if (($thousandths < 1) || ($thousandths > self::MAX_THOUSANDTHS)) {
+ return null;
+ }
+
+ return new self($thousandths);
+ }
+
+ public function getThousandths(): int
+ {
+ return $this->thousandths;
+ }
+
+ /**
+ * : .
+ */
+ public function isWhole(): bool
+ {
+ return $this->thousandths % self::SCALE === 0;
+ }
+
+ /**
+ * ; {@see self::isWhole()}.
+ */
+ public function getPieces(): int
+ {
+ return intdiv($this->thousandths, self::SCALE);
+ }
+
+ /**
+ * : `2`, `2.5`, `0.125`.
+ */
+ public function toDecimal(): string
+ {
+ if ($this->isWhole()) {
+ return (string) $this->getPieces();
+ }
+
+ return rtrim(
+ sprintf('%d.%03d', intdiv($this->thousandths, self::SCALE), $this->thousandths % self::SCALE),
+ '0',
+ );
+ }
+
+ /**
+ * : x , ( ).
+ */
+ public function totalOf(Money $price): Money
+ {
+ return Money::fromMinorUnits(
+ intdiv(($price->toMinorUnits() * $this->thousandths) + intdiv(self::SCALE, 2), self::SCALE),
+ );
+ }
+}
diff --git a/moneta/class/receipt/Receipt.php b/moneta/class/receipt/Receipt.php
new file mode 100644
index 0000000..6e20c5e
--- /dev/null
+++ b/moneta/class/receipt/Receipt.php
@@ -0,0 +1,111 @@
+ */
+ private $items;
+
+ /**
+ * @param array $items
+ */
+ public function __construct(?ReceiptClient $client, array $items)
+ {
+ if ($items === []) {
+ throw new InvalidArgumentException(' .');
+ }
+
+ $this->client = $client;
+ $this->items = array_values($items);
+ }
+
+ public function getClient(): ?ReceiptClient
+ {
+ return $this->client;
+ }
+
+ /**
+ * @return array
+ */
+ public function getItems(): array
+ {
+ return $this->items;
+ }
+
+ public function total(): Money
+ {
+ $total = Money::fromMinorUnits(0);
+ foreach ($this->items as $item) {
+ $total = $total->add($item->total());
+ }
+
+ return $total;
+ }
+
+ /**
+ * `MNT_ATTRIBUTES`: `INVENTORY` ; `CLIENT`, `CUSTOMER` (email), `PHONE` ( `+`)
+ * ; `SNO` , .
+ * `DELIVERY` : `INVENTORY`.
+ * ({@see ReceiptItem::toInventoryPosition()}).
+ *
+ * @return array
+ */
+ public function toAttributes(bool $fiscalization = true, ?TaxSystem $taxSystem = null): array
+ {
+ $attributes = [
+ 'INVENTORY' => JsonNumber::encode(
+ array_map(static function (ReceiptItem $item) use ($fiscalization): array {
+ return $item->toInventoryPosition($fiscalization);
+ }, $this->items),
+ ),
+ ];
+
+ $client = ($this->client !== null) ? $this->client->toArray(ReceiptClient::KASSA_PHONE_MAX_LENGTH) : [];
+ if ($client !== []) {
+ $attributes['CLIENT'] = JsonNumber::encode([$client]);
+ if (isset($client['email'])) {
+ $attributes['CUSTOMER'] = $client['email'];
+ }
+ if (isset($client['phone'])) {
+ $attributes['PHONE'] = ltrim($client['phone'], '+');
+ }
+ }
+
+ if ($fiscalization && ($taxSystem !== null) && $taxSystem->isPassed()) {
+ $attributes['SNO'] = $taxSystem->getValue();
+ }
+
+ return $attributes;
+ }
+
+ /**
+ * `receipt` JSON- Check URL. `client` (`{}`).
+ *
+ * @return array
+ */
+ public function toJsonReceipt(): array
+ {
+ $client = $this->client !== null ? $this->client->toArray(ReceiptClient::JSON_PHONE_MAX_LENGTH) : [];
+
+ return [
+ 'client' => $client === [] ? new \stdClass() : $client,
+ 'items' => array_map(static function (ReceiptItem $item): array {
+ return $item->toCheckItem();
+ }, $this->items),
+ ];
+ }
+}
diff --git a/moneta/class/receipt/ReceiptBuilder.php b/moneta/class/receipt/ReceiptBuilder.php
new file mode 100644
index 0000000..97c83ab
--- /dev/null
+++ b/moneta/class/receipt/ReceiptBuilder.php
@@ -0,0 +1,360 @@
+ UTF-8
+ * @param PaymentMethod $paymentMethod
+ * @param PaymentObject|null $goodsObject ; null .
+ * .
+ * @param Vat|null $paymentVat : ;
+ * null
+ */
+ public function __construct(
+ Closure $toUtf8,
+ PaymentMethod $paymentMethod,
+ ?PaymentObject $goodsObject = null,
+ ?Vat $paymentVat = null
+ ) {
+ $this->toUtf8 = $toUtf8;
+ $this->paymentMethod = $paymentMethod;
+ $this->goodsObject = $goodsObject ?? PaymentObject::commodity();
+ $this->paymentVat = $paymentVat ?? Vat::none();
+ }
+
+ /**
+ * @param Vat $goodsVat PHPShop
+ * @param Vat $deliveryVat
+ * @param string $fallbackEmail Email ,
+ */
+ public function build(Order $order, Vat $goodsVat, Vat $deliveryVat, string $fallbackEmail): Receipt
+ {
+ $client = ReceiptClient::fromContacts(
+ $order->getEmail(),
+ $order->getPhone(),
+ $this->utf8($order->getCustomerName()),
+ $fallbackEmail,
+ );
+
+ $amount = $order->getAmount()->toMinorUnits();
+
+ $items = $this->items($this->balance($this->lines($order, $goodsVat, $deliveryVat), $amount));
+ if ($items === null) {
+ $items = [
+ new ReceiptItem(
+ $this->utf8(self::PAYMENT_NAME . $order->getUid()),
+ $order->getAmount(),
+ Quantity::pieces(1),
+ $this->paymentVat,
+ $this->goodsObject,
+ $this->paymentMethod,
+ ),
+ ];
+ }
+
+ return new Receipt($client, $items);
+ }
+
+ /**
+ * (`PHPShopDone::send_to_order()`):
+ * -, . ,
+ * ( ), `ed_izm` .
+ *
+ * @return array
+ */
+ private function lines(Order $order, Vat $goodsVat, Vat $deliveryVat): array
+ {
+ $cart = $order->getCart();
+ $lines = [];
+ $products = isset($cart['cart']) && is_array($cart['cart']) ? $cart['cart'] : [];
+ $discount = $order->getDiscountPercent();
+ foreach ($products as $product) {
+ if (!is_array($product)) {
+ continue;
+ }
+
+ $price = (float) ($product['price'] ?? 0);
+ if (($discount > 0) && empty($product['promo_price'])) {
+ $price -= $price * $discount / 100;
+ }
+
+ $quantity = Quantity::fromCart($product['num'] ?? null);
+ if (($quantity === null) || ($price <= 0)) {
+ continue;
+ }
+
+ $lines[] = [
+ 'name' => $this->name((string) ($product['name'] ?? '')),
+ 'unit' => Money::fromFloat($price)->toMinorUnits(),
+ 'quantity' => $quantity,
+ 'measure' => Measure::fromUnit($this->utf8((string) ($product['ed_izm'] ?? '')), $this->toUtf8),
+ 'vat' => $goodsVat,
+ 'delivery' => false,
+ ];
+ }
+
+ $delivery = (float) ($cart['dostavka'] ?? 0);
+ if ($delivery > 0) {
+ $lines[] = [
+ 'name' => $this->utf8(self::DELIVERY_NAME),
+ 'unit' => Money::fromFloat($delivery)->toMinorUnits(),
+ 'quantity' => Quantity::pieces(1),
+ 'measure' => Measure::UNIT,
+ 'vat' => $deliveryVat,
+ 'delivery' => true,
+ ];
+ }
+
+ return $lines;
+ }
+
+ /**
+ * . ;
+ * ;
+ * , . ,
+ * . .
+ *
+ * @param array $lines
+ *
+ * @return array
+ */
+ private function balance(array $lines, int $target): array
+ {
+ if (($target <= 0) || ($lines === [])) {
+ return [];
+ }
+
+ $totals = [];
+ foreach ($lines as $index => $line) {
+ $totals[$index] = self::lineTotal($line);
+ }
+ if (array_sum($totals) === $target) {
+ return $lines;
+ }
+
+ $stages = [
+ static function (array $line): bool {
+ return !$line['delivery'] && $line['quantity']->isWhole();
+ },
+ static function (array $line): bool {
+ return $line['quantity']->isWhole();
+ },
+ static function (array $line): bool {
+ return true;
+ },
+ ];
+ foreach ($stages as $isAdjustable) {
+ $adjustable = [];
+ $fixed = 0;
+ foreach ($lines as $index => $line) {
+ if ($isAdjustable($line)) {
+ $adjustable[] = $index;
+ } else {
+ $fixed += $totals[$index];
+ }
+ }
+ if (($adjustable === []) || ($target - $fixed <= 0)) {
+ continue;
+ }
+
+ return $this->distribute($lines, $totals, $adjustable, $target - $fixed);
+ }
+
+ return [];
+ }
+
+ /**
+ * `$goal` `$adjustable` .
+ *
+ * @param array $lines
+ * @param array $totals
+ * @param array $adjustable ,
+ *
+ * @return array
+ */
+ private function distribute(array $lines, array $totals, array $adjustable, int $goal): array
+ {
+ $base = 0;
+ foreach ($adjustable as $index) {
+ $base += $totals[$index];
+ }
+ if ($base <= 0) {
+ return [];
+ }
+
+ // : , .
+ $shares = [];
+ $remainders = [];
+ foreach ($adjustable as $index) {
+ if ($totals[$index] > intdiv(PHP_INT_MAX, $goal)) {
+ return [];
+ }
+
+ $product = $totals[$index] * $goal;
+ $shares[$index] = intdiv($product, $base);
+ $remainders[$index] = $product % $base;
+ }
+ arsort($remainders);
+ $left = $goal - array_sum($shares);
+ foreach (array_keys($remainders) as $index) {
+ if ($left <= 0) {
+ break;
+ }
+ $shares[$index]++;
+ $left--;
+ }
+
+ $balanced = [];
+ foreach ($lines as $index => $line) {
+ if (!isset($shares[$index])) {
+ $balanced[] = $line;
+ continue;
+ }
+
+ $parts = $line['quantity']->isWhole()
+ ? $this->split($line, $shares[$index])
+ : $this->reprice($line, $shares[$index]);
+ if ($parts === []) {
+ return [];
+ }
+ foreach ($parts as $part) {
+ $balanced[] = $part;
+ }
+ }
+
+ return $balanced;
+ }
+
+ /**
+ * : ,
+ * . .
+ *
+ * @param array{name: string, unit: int, quantity: Quantity, measure: string, vat: Vat, delivery: bool} $line
+ *
+ * @return array
+ */
+ private function split(array $line, int $total): array
+ {
+ $pieces = $line['quantity']->getPieces();
+ $unit = intdiv($total, $pieces);
+ $rest = $total - ($unit * $pieces);
+
+ $parts = [];
+ if ($rest > 0) {
+ $parts[] = ['unit' => $unit + 1, 'quantity' => Quantity::pieces($rest)] + $line;
+ }
+ if (($unit > 0) && ($pieces - $rest > 0)) {
+ $parts[] = ['unit' => $unit, 'quantity' => Quantity::pieces($pieces - $rest)] + $line;
+ }
+
+ return $parts;
+ }
+
+ /**
+ * : , x
+ * `$total`. ( 2.5 23 ) .
+ *
+ * @param array{name: string, unit: int, quantity: Quantity, measure: string, vat: Vat, delivery: bool} $line
+ *
+ * @return array
+ */
+ private function reprice(array $line, int $total): array
+ {
+ $thousandths = $line['quantity']->getThousandths();
+ $estimate = intdiv(($total * 1000) + intdiv($thousandths, 2), $thousandths);
+ foreach ([$estimate, $estimate - 1, $estimate + 1] as $unit) {
+ if ($unit > 0 && self::lineTotal(['unit' => $unit] + $line) === $total) {
+ return [['unit' => $unit] + $line];
+ }
+ }
+
+ return [];
+ }
+
+ /**
+ * @param array{unit: int, quantity: Quantity} $line
+ */
+ private static function lineTotal(array $line): int
+ {
+ return $line['quantity']->totalOf(Money::fromMinorUnits($line['unit']))->toMinorUnits();
+ }
+
+ /**
+ * @param array $lines
+ *
+ * @return array|null null
+ */
+ private function items(array $lines): ?array
+ {
+ if ($lines === []) {
+ return null;
+ }
+
+ $items = [];
+ try {
+ foreach ($lines as $line) {
+ $items[] = new ReceiptItem(
+ $line['name'],
+ Money::fromMinorUnits($line['unit']),
+ $line['quantity'],
+ $line['vat'],
+ $line['delivery'] ? PaymentObject::service() : $this->goodsObject,
+ $this->paymentMethod,
+ $line['measure'],
+ );
+ }
+ } catch (InvalidArgumentException $exception) {
+ return null;
+ }
+
+ return $items;
+ }
+
+ private function name(string $raw): string
+ {
+ $name = ReceiptText::clean($this->utf8($raw), ReceiptItem::NAME_MAX_LENGTH);
+
+ return ($name !== '') ? $name : $this->utf8(self::ITEM_FALLBACK_NAME);
+ }
+
+ private function utf8(string $value): string
+ {
+ return ($this->toUtf8)($value);
+ }
+}
diff --git a/moneta/class/receipt/ReceiptClient.php b/moneta/class/receipt/ReceiptClient.php
new file mode 100644
index 0000000..9d6a1ce
--- /dev/null
+++ b/moneta/class/receipt/ReceiptClient.php
@@ -0,0 +1,107 @@
+name = $name;
+ $this->email = $email;
+ $this->phone = $phone;
+ }
+
+ /**
+ * null, . Email
+ * , email, ; .
+ */
+ public static function fromContacts(string $email, string $phone, string $name, string $fallbackEmail): ?self
+ {
+ $phone = PhoneNumber::normalize($phone) ?? '';
+ if (strlen($phone) > self::KASSA_PHONE_MAX_LENGTH) {
+ $phone = '';
+ }
+
+ $email = self::email($email);
+ if (($email === '') && ($phone === '')) {
+ $email = self::email($fallbackEmail);
+ }
+ if (($email === '') && ($phone === '')) {
+ return null;
+ }
+
+ return new self(ReceiptText::clean($name, self::NAME_MAX_LENGTH), $email, $phone);
+ }
+
+ public function getEmail(): string
+ {
+ return $this->email;
+ }
+
+ public function getPhone(): string
+ {
+ return $this->phone;
+ }
+
+ /**
+ * `client`; .
+ *
+ * @param int $phoneMaxLength {@see self::JSON_PHONE_MAX_LENGTH} {@see self::KASSA_PHONE_MAX_LENGTH}
+ *
+ * @return array
+ */
+ public function toArray(int $phoneMaxLength): array
+ {
+ $phone = strlen($this->phone) <= $phoneMaxLength ? $this->phone : '';
+ if (($this->email === '') && ($phone === '')) {
+ // , email .
+ return [];
+ }
+
+ return array_filter(
+ ['name' => $this->name, 'email' => $this->email, 'phone' => $phone],
+ static function (string $value): bool {
+ return ($value !== '');
+ },
+ );
+ }
+
+ private static function email(string $email): string
+ {
+ $email = trim($email);
+ if (
+ strlen($email) > self::EMAIL_MAX_LENGTH
+ || filter_var($email, FILTER_VALIDATE_EMAIL) === false
+ ) {
+ return '';
+ }
+
+ return $email;
+ }
+}
diff --git a/moneta/class/receipt/ReceiptItem.php b/moneta/class/receipt/ReceiptItem.php
new file mode 100644
index 0000000..ecc68ce
--- /dev/null
+++ b/moneta/class/receipt/ReceiptItem.php
@@ -0,0 +1,168 @@
+name = ReceiptText::clean($name, self::NAME_MAX_LENGTH);
+ if ($this->name === '') {
+ throw new InvalidArgumentException(' .');
+ }
+ $this->price = $price;
+ $this->quantity = $quantity;
+ $this->measure = $measure;
+ $this->vat = $vat;
+ $this->paymentObject = $paymentObject ?? PaymentObject::commodity();
+ $this->paymentMethod = $paymentMethod ?? PaymentMethod::fullPayment();
+
+ $max = Money::fromDecimal(self::PRICE_MAX)->toMinorUnits();
+ if (($price->toMinorUnits() > $max) || ($this->total()->toMinorUnits() > $max)) {
+ throw new InvalidArgumentException(' .');
+ }
+ }
+
+ public function getName(): string
+ {
+ return $this->name;
+ }
+
+ public function getPrice(): Money
+ {
+ return $this->price;
+ }
+
+ public function getQuantity(): Quantity
+ {
+ return $this->quantity;
+ }
+
+ public function getMeasure(): string
+ {
+ return $this->measure;
+ }
+
+ public function getVat(): Vat
+ {
+ return $this->vat;
+ }
+
+ public function getPaymentObject(): PaymentObject
+ {
+ return $this->paymentObject;
+ }
+
+ public function getPaymentMethod(): PaymentMethod
+ {
+ return $this->paymentMethod;
+ }
+
+ /**
+ * , : x .
+ */
+ public function total(): Money
+ {
+ return $this->quantity->totalOf($this->price);
+ }
+
+ /**
+ * `items` JSON- Check URL; {@see JsonNumber}.
+ *
+ * @return array
+ */
+ public function toCheckItem(): array
+ {
+ return [
+ 'name' => $this->name,
+ 'price' => JsonNumber::placeholder($this->price),
+ 'quantity' => JsonNumber::quantity($this->quantity),
+ 'measure' => $this->measure,
+ 'paymentMethod' => $this->paymentMethod->getValue(),
+ 'paymentObject' => $this->paymentObject->getValue(),
+ 'vat' => $this->vat->getCode(),
+ ];
+ }
+
+ /**
+ * `inventPositions` `INVENTORY`. ,
+ * MONETA.RU : `vatTag`, `pm`, `po`.
+ *
+ * @return array
+ */
+ public function toInventoryPosition(bool $fiscalization = true): array
+ {
+ $position = [
+ 'name' => $this->name,
+ 'price' => JsonNumber::placeholder($this->price),
+ 'quantity' => JsonNumber::quantity($this->quantity),
+ 'measure' => $this->measure,
+ ];
+ if (!$fiscalization) {
+ return $position;
+ }
+
+ return $position + [
+ 'vatTag' => $this->vat->getTag(),
+ 'pm' => $this->paymentMethod->getValue(),
+ 'po' => $this->paymentObject->getValue(),
+ ];
+ }
+}
diff --git a/moneta/class/receipt/ReceiptText.php b/moneta/class/receipt/ReceiptText.php
new file mode 100644
index 0000000..77c399e
--- /dev/null
+++ b/moneta/class/receipt/ReceiptText.php
@@ -0,0 +1,39 @@
+ , `kassaspecification.pdf`. */
+ public const LABELS = [
+ self::KASSA => ' ( )',
+ '1' => ' ()',
+ '2' => ' () ',
+ '3' => ' () ',
+ '4' => ' ()',
+ '5' => ' ()',
+ '6' => ' ()',
+ ];
+
+ /** @var string */
+ private $value;
+
+ private function __construct(string $value)
+ {
+ $this->value = $value;
+ }
+
+ /**
+ * ; .
+ */
+ public static function fromSetting(?string $value): self
+ {
+ $value = (string) $value;
+
+ return new self(isset(self::LABELS[$value]) ? $value : self::KASSA);
+ }
+
+ public static function kassa(): self
+ {
+ return new self(self::KASSA);
+ }
+
+ public function getValue(): string
+ {
+ return $this->value;
+ }
+
+ public function isPassed(): bool
+ {
+ return ($this->value !== self::KASSA);
+ }
+}
diff --git a/moneta/class/receipt/Vat.php b/moneta/class/receipt/Vat.php
new file mode 100644
index 0000000..22cad5b
--- /dev/null
+++ b/moneta/class/receipt/Vat.php
@@ -0,0 +1,107 @@
+ `vat`. */
+ private const BY_PERCENT = [
+ 0 => 'vat0',
+ 5 => 'vat5',
+ 7 => 'vat7',
+ 10 => 'vat10',
+ 20 => 'vat20',
+ 22 => 'vat22',
+ ];
+
+ /**
+ * `vat` (`cmsspecification.pdf`) -> `vatTag` (`kassaspecification.pdf`).
+ */
+ private const TAGS = [
+ self::NONE => '1105',
+ 'vat0' => '1104',
+ 'vat5' => '1108',
+ 'vat7' => '1109',
+ 'vat10' => '1103',
+ 'vat20' => '1102',
+ 'vat22' => '1113',
+ 'vat105' => '1110',
+ 'vat107' => '1111',
+ 'vat110' => '1107',
+ 'vat120' => '1106',
+ 'vat122' => '1114',
+ ];
+
+ /** @var string */
+ private $code;
+
+ private function __construct(string $code)
+ {
+ $this->code = $code;
+ }
+
+ public static function none(): self
+ {
+ return new self(self::NONE);
+ }
+
+ /**
+ * `vat`; null.
+ */
+ public static function fromCode(string $code): ?self
+ {
+ return isset(self::TAGS[$code]) ? new self($code) : null;
+ }
+
+ /**
+ * PHPShop (`nds`, `ofd_nds` ).
+ * ѻ: .
+ */
+ public static function fromPercent(string $percent): self
+ {
+ return self::tryFromPercent($percent) ?? self::none();
+ }
+
+ /**
+ * {@see self::fromPercent()}, null:
+ * , ѻ.
+ */
+ public static function tryFromPercent(string $percent): ?self
+ {
+ $percent = trim($percent);
+ if (preg_match('/\A[0-9]{1,3}(?:[.,]0+)?\z/', $percent) !== 1) {
+ return null;
+ }
+ $value = (int) $percent;
+
+ return isset(self::BY_PERCENT[$value]) ? new self(self::BY_PERCENT[$value]) : null;
+ }
+
+ public function getCode(): string
+ {
+ return $this->code;
+ }
+
+ public function getTag(): string
+ {
+ return self::TAGS[$this->code];
+ }
+
+ public function equals(self $other): bool
+ {
+ return ($this->code === $other->code);
+ }
+}
diff --git a/moneta/class/receipt/VatRateWarnings.php b/moneta/class/receipt/VatRateWarnings.php
new file mode 100644
index 0000000..0d8f6e9
--- /dev/null
+++ b/moneta/class/receipt/VatRateWarnings.php
@@ -0,0 +1,63 @@
+ $deliveries : [, ѻ
+ * (`ofd_nds`, )]
+ *
+ * @return array : ` PHPShop (): 23`
+ */
+ public static function find(
+ bool $fiscalization,
+ bool $vatEnabled,
+ VatSetting $goodsVat,
+ VatSetting $deliveryVat,
+ string $systemPercent,
+ array $deliveries
+ ): array {
+ if (!$fiscalization || !$vatEnabled) {
+ return [];
+ }
+
+ $warnings = [];
+ if ($goodsVat->getFixed() === null && Vat::tryFromPercent($systemPercent) === null) {
+ $warnings[] = ' PHPShop (): ' . self::shown($systemPercent);
+ }
+ if ($deliveryVat->getFixed() === null) {
+ foreach ($deliveries as [$name, $percent]) {
+ $percent = (trim($percent) !== '') ? $percent : $systemPercent;
+ if (Vat::tryFromPercent($percent) === null) {
+ $warnings[] = ' ' . $name . ': ' . self::shown($percent);
+ }
+ }
+ }
+
+ return $warnings;
+ }
+
+ /**
+ * : , .
+ */
+ public static function shown(string $percent): string
+ {
+ $percent = trim($percent);
+
+ return ($percent === '') ? ' ' : $percent . '%';
+ }
+}
diff --git a/moneta/class/receipt/VatSetting.php b/moneta/class/receipt/VatSetting.php
new file mode 100644
index 0000000..e90f6bc
--- /dev/null
+++ b/moneta/class/receipt/VatSetting.php
@@ -0,0 +1,79 @@
+ . */
+ public const FIXED_LABELS = [
+ Vat::NONE => ' ',
+ 'vat0' => ' 0%',
+ 'vat5' => ' 5%',
+ 'vat7' => ' 7%',
+ 'vat10' => ' 10%',
+ 'vat20' => ' 20%',
+ 'vat22' => ' 22%',
+ 'vat105' => ' 5% ( 5/105)',
+ 'vat107' => ' 7% ( 7/107)',
+ 'vat110' => ' 10% ( 10/110)',
+ 'vat120' => ' 20% ( 20/120)',
+ 'vat122' => ' 22% ( 22/122)',
+ ];
+
+ /** @var Vat|null */
+ private $fixed;
+
+ private function __construct(?Vat $fixed)
+ {
+ $this->fixed = $fixed;
+ }
+
+ /**
+ * ; , {@see self::PLATFORM} PHPShop.
+ */
+ public static function fromSetting(?string $value): self
+ {
+ $value = (string) $value;
+
+ return new self(isset(self::FIXED_LABELS[$value]) ? Vat::fromCode($value) : null);
+ }
+
+ public static function platform(): self
+ {
+ return new self(null);
+ }
+
+ /**
+ * null PHPShop.
+ */
+ public function getFixed(): ?Vat
+ {
+ return $this->fixed;
+ }
+
+ public function getValue(): string
+ {
+ return ($this->fixed !== null) ? $this->fixed->getCode() : self::PLATFORM;
+ }
+
+ /**
+ * : PHPShop `$platformLabel`.
+ *
+ * @return array
+ */
+ public static function labels(string $platformLabel): array
+ {
+ return [self::PLATFORM => $platformLabel] + self::FIXED_LABELS;
+ }
+}
diff --git a/moneta/core/moneta.core.php b/moneta/core/moneta.core.php
new file mode 100644
index 0000000..12f7871
--- /dev/null
+++ b/moneta/core/moneta.core.php
@@ -0,0 +1,118 @@
+`.
+ */
+class PHPShopMoneta extends PHPShopCore
+{
+ public function __construct()
+ {
+ parent::__construct();
+ }
+
+ public function index()
+ {
+ $result = self::query('result');
+ $transactionId = self::query('MNT_TRANSACTION_ID');
+ $attempt = max(0, min(ReturnMessage::MAX_ATTEMPTS, (int) self::query('attempt')));
+
+ $message = $this->returnMessage($result, $transactionId, $attempt);
+ if ($message === null) {
+ $this->setError404();
+
+ return;
+ }
+
+ $orderUid = $message->getOrderUid();
+ $refreshUrl = $message->isWaiting()
+ ? '?' . http_build_query([
+ 'result' => $result,
+ 'MNT_TRANSACTION_ID' => $transactionId,
+ 'attempt' => $attempt + 1,
+ ])
+ : '';
+
+ $this->title = HostCharset::toPage($message->getTitle());
+ $this->set('monetaReturnIcon', $message->getIcon());
+ $this->set('monetaReturnTitle', self::escape($message->getTitle()));
+ $this->set('monetaReturnText', self::escape($message->getText()));
+ $this->set('monetaReturnOrderUrl', self::escape('/users/order.html?order_info=' . rawurlencode($orderUid) . '#Order'));
+ $this->set('monetaReturnOrderHide', $orderUid === '' ? 'moneta-hide' : '');
+ $this->set('monetaReturnRefreshUrl', self::escape($refreshUrl));
+ $this->set('monetaReturnRefreshDelay', (string) ReturnMessage::REFRESH_DELAY_MS);
+
+ // (cp1251) : UTF-8-
+ // , , .
+ $this->parseTemplate($GLOBALS['SysValue']['templates']['moneta']['moneta_return_forma'], true);
+ $this->Disp = HostCharset::toPage((string) $this->Disp);
+ }
+
+ /**
+ * `MNT_TRANSACTION_ID`
+ * ({@see ReturnAccess::findOrder()}). : `result`.
+ */
+ private function returnMessage(string $result, string $transactionId, int $attempt): ?ReturnMessage
+ {
+ $order = null;
+ $paidByJournal = false;
+ $settings = null;
+ $transactionGiven = $transactionId !== '';
+
+ try {
+ $settings = (new SettingsRepository())->load();
+ if ($transactionGiven) {
+ $order = ReturnAccess::findOrder(
+ $transactionId,
+ new OrderRepository(),
+ (int) ($_SESSION['UsersId'] ?? 0),
+ $_SESSION[ReturnAccess::SESSION_KEY] ?? null,
+ );
+ if ($order !== null) {
+ $paidByJournal = (new OperationRepository(Database::fromHost()))->findPaidOperation($order->getId()) !== null;
+ }
+ }
+ } catch (\Throwable $exception) {
+ (new ErrorLogLogger())->error(
+ ' : ' . get_class($exception) . ': ' . $exception->getMessage(),
+ );
+ $order = null;
+ $transactionGiven = false;
+ }
+
+ return ReturnMessage::resolve(
+ $result,
+ $transactionGiven,
+ $order,
+ $paidByJournal,
+ $settings ?? Settings::fromRow([]),
+ $attempt,
+ );
+ }
+
+ private static function query(string $name): string
+ {
+ return isset($_GET[$name]) && is_string($_GET[$name]) ? $_GET[$name] : '';
+ }
+
+ private static function escape(string $value): string
+ {
+ return htmlspecialchars($value, ENT_QUOTES, 'Windows-1251');
+ }
+}
diff --git a/moneta/hook/done_moneta.hook.php b/moneta/hook/done_moneta.hook.php
new file mode 100644
index 0000000..da678ee
--- /dev/null
+++ b/moneta/hook/done_moneta.hook.php
@@ -0,0 +1,46 @@
+ $value $_POST
+ * @param string $rout : START | MIDDLE | END
+ */
+function send_to_order_mod_moneta_hook($obj, $value, $rout)
+{
+ require_once dirname(__DIR__) . '/class/autoload.php';
+
+ if (($rout !== 'END') || empty($obj->orderId)) {
+ return null;
+ }
+
+ if ((int) ($value['order_metod'] ?? 0) !== \MonetaPhpShop\ModuleInfo::PAYMENT_METHOD_ID) {
+ return null;
+ }
+
+ $block = \MonetaPhpShop\host\CheckoutView::create()->afterCheckout((int) $obj->orderId);
+ if ($block->isEmpty()) {
+ $obj->set('orderMesage', '');
+
+ return null;
+ }
+
+ $obj->set('payment_info', $block->getInfo());
+ $obj->set('payment_info_hide', $block->getInfo() === '' ? 'moneta-hide' : '');
+ $obj->set('payment_forma', $block->getForm());
+ $obj->set('moneta_total', $block->getTotal());
+ $obj->set('moneta_total_hide', $block->getTotal() === '' ? 'moneta-hide' : '');
+ $html = ParseTemplateReturn($GLOBALS['SysValue']['templates']['moneta']['moneta_payment_forma'], true);
+ $obj->set('orderMesage', \MonetaPhpShop\host\HostCharset::toPage((string) $html));
+
+ return null;
+}
+
+$addHandler = [
+ 'send_to_order' => 'send_to_order_mod_moneta_hook',
+];
diff --git a/moneta/hook/fail_moneta.hook.php b/moneta/hook/fail_moneta.hook.php
new file mode 100644
index 0000000..49bc7f6
--- /dev/null
+++ b/moneta/hook/fail_moneta.hook.php
@@ -0,0 +1,29 @@
+returnPagePath()))
+ ->withTransaction(\MonetaPhpShop\form\ReturnUrls::RESULT_FAIL, $_GET['MNT_TRANSACTION_ID'] ?? null);
+ if ($url === null) {
+ return null;
+ }
+
+ header('Location: ' . $url, true, 302);
+ exit;
+}
+
+$addHandler = [
+ 'index' => 'fail_mod_moneta_hook',
+];
diff --git a/moneta/hook/success_moneta.hook.php b/moneta/hook/success_moneta.hook.php
new file mode 100644
index 0000000..a52c96a
--- /dev/null
+++ b/moneta/hook/success_moneta.hook.php
@@ -0,0 +1,29 @@
+returnPagePath()))
+ ->withTransaction(\MonetaPhpShop\form\ReturnUrls::RESULT_SUCCESS, $_GET['MNT_TRANSACTION_ID'] ?? null);
+ if ($url === null) {
+ return null;
+ }
+
+ header('Location: ' . $url, true, 302);
+ exit;
+}
+
+$addHandler = [
+ 'index' => 'success_mod_moneta_hook',
+];
diff --git a/moneta/hook/userorderpaymentlink_moneta.hook.php b/moneta/hook/userorderpaymentlink_moneta.hook.php
new file mode 100644
index 0000000..3123430
--- /dev/null
+++ b/moneta/hook/userorderpaymentlink_moneta.hook.php
@@ -0,0 +1,29 @@
+order_metod_id !== \MonetaPhpShop\ModuleInfo::PAYMENT_METHOD_ID) {
+ return null;
+ }
+
+ // PHPShopOrderFunction , objID.
+ $orderId = (int) ($PHPShopOrderFunction->objRow['id'] ?? $PHPShopOrderFunction->objID ?? 0);
+
+ return \MonetaPhpShop\host\CheckoutView::create()->inAccount($orderId);
+}
+
+$addHandler = [
+ 'userorderpaymentlink' => 'userorderpaymentlink_mod_moneta_hook',
+];
diff --git a/moneta/inc/config.ini b/moneta/inc/config.ini
new file mode 100644
index 0000000..bf069a2
--- /dev/null
+++ b/moneta/inc/config.ini
@@ -0,0 +1,21 @@
+; PHPShop (PHPShopModules::getIni()).
+; [base] .
+
+[base]
+moneta_system="phpshop_modules_moneta_system";
+moneta_operations="phpshop_modules_moneta_operations";
+moneta_log_throttle="phpshop_modules_moneta_log_throttle";
+
+[hook]
+phpshopdone="./phpshop/modules/moneta/hook/done_moneta.hook.php";
+userorderpaymentlink="./phpshop/modules/moneta/hook/userorderpaymentlink_moneta.hook.php";
+; /success /fail .
+phpshopsuccess="./phpshop/modules/moneta/hook/success_moneta.hook.php";
+phpshopfail="./phpshop/modules/moneta/hook/fail_moneta.hook.php";
+
+[core]
+moneta="./phpshop/modules/moneta/core/moneta.core.php";
+
+[templates]
+moneta_payment_forma="./phpshop/modules/moneta/templates/payment_forma.tpl";
+moneta_return_forma="./phpshop/modules/moneta/templates/return_forma.tpl";
diff --git a/moneta/install/module.sql b/moneta/install/module.sql
new file mode 100644
index 0000000..b0535db
--- /dev/null
+++ b/moneta/install/module.sql
@@ -0,0 +1,63 @@
+DROP TABLE IF EXISTS `phpshop_modules_moneta_system`;
+-- title_end , PHPShop:
+-- . .
+CREATE TABLE IF NOT EXISTS `phpshop_modules_moneta_system` (
+ `id` int(11) NOT NULL auto_increment,
+ `account_id` varchar(20) NOT NULL default '',
+ `integrity_code` varchar(255) NOT NULL default '',
+ `payment_server` varchar(8) NOT NULL default 'PROD',
+ `test_mode` enum('0','1') NOT NULL default '0',
+ `fiscalization` enum('0','1') NOT NULL default '0',
+ `receipt_email` varchar(64) NOT NULL default '',
+ `sno` varchar(1) NOT NULL default '',
+ `payment_method` varchar(32) NOT NULL default 'full_payment',
+ `payment_object` varchar(32) NOT NULL default 'commodity',
+ `goods_vat` varchar(16) NOT NULL default 'platform',
+ `delivery_vat` varchar(16) NOT NULL default 'platform',
+ `status` int(11) NOT NULL default '0',
+ `paid_status` int(11) NOT NULL default '101',
+ `title_end` text,
+ `version` varchar(64) NOT NULL default '2.0',
+ PRIMARY KEY (`id`)
+) ENGINE=MyISAM DEFAULT CHARSET=cp1251;
+
+-- : Check/Pay URL.
+-- paid_order_id UNIQUE (MyISAM, ).
+DROP TABLE IF EXISTS `phpshop_modules_moneta_operations`;
+CREATE TABLE IF NOT EXISTS `phpshop_modules_moneta_operations` (
+ `id` int(11) NOT NULL auto_increment,
+ `created_at` int(11) NOT NULL default '0',
+ `command` varchar(8) NOT NULL default '',
+ `transaction_id` varchar(255) NOT NULL default '',
+ `operation_id` varchar(255) NOT NULL default '',
+ `order_id` int(11) NOT NULL default '0',
+ `order_uid` varchar(64) NOT NULL default '',
+ `amount` varchar(20) NOT NULL default '',
+ `test_mode` enum('0','1') NOT NULL default '0',
+ `result_code` int(11) default NULL,
+ `event` varchar(32) NOT NULL default '',
+ `paid_order_id` int(11) default NULL,
+ PRIMARY KEY (`id`),
+ UNIQUE KEY `paid_order_id` (`paid_order_id`),
+ KEY `order_id` (`order_id`)
+) ENGINE=MyISAM DEFAULT CHARSET=cp1251;
+
+DROP TABLE IF EXISTS `phpshop_modules_moneta_log_throttle`;
+-- : , .
+-- MyISAM , .
+CREATE TABLE IF NOT EXISTS `phpshop_modules_moneta_log_throttle` (
+ `id` int(11) NOT NULL default '1',
+ `logged_at` int(11) NOT NULL default '0',
+ `skipped` int(11) NOT NULL default '0',
+ PRIMARY KEY (`id`)
+) ENGINE=MyISAM DEFAULT CHARSET=cp1251;
+INSERT IGNORE INTO `phpshop_modules_moneta_log_throttle` (`id`, `logged_at`, `skipped`) VALUES (1, 0, 0);
+
+INSERT INTO `phpshop_modules_moneta_system` (`id`, `title_end`, `version`) VALUES
+(1, ' ', '2.0');
+
+-- num , .
+-- 0, ,
+-- -1 . .
+INSERT IGNORE INTO `phpshop_payment_systems` (`id`, `name`, `path`, `enabled`, `num`, `message`, `message_header`, `yur_data_flag`, `icon`) VALUES
+(10048, ' , Pay- ()', 'modules', '0', -1, '', '', '0', 'phpshop/modules/moneta/templates/moneta.svg');
diff --git a/moneta/install/module.xml b/moneta/install/module.xml
new file mode 100644
index 0000000..be7d9bf
--- /dev/null
+++ b/moneta/install/module.xml
@@ -0,0 +1,15 @@
+
+
+ 2.0
+
+ , Pay-
+ payment
+
+
+ true
+
+
+ dir.moneta
+
+
+
diff --git a/moneta/payment/callback.php b/moneta/payment/callback.php
new file mode 100644
index 0000000..5a375f4
--- /dev/null
+++ b/moneta/payment/callback.php
@@ -0,0 +1,89 @@
+ 0) {
+ ob_end_clean();
+ }
+ header('Content-Type: ' . $response->getContentType());
+ echo $response->getBody();
+}
+
+$logger = new ErrorLogLogger();
+
+// checkInstall() exit .
+// , : .
+if (empty($PHPShopModules->ModValue['base'][ModuleInfo::PATH])) {
+ $logger->error(' : PHPShop.');
+ moneta_callback_send(CallbackResponse::fail());
+ exit;
+}
+
+try {
+ $database = Database::fromHost();
+ $shopContext = new ShopContext();
+ $settings = (new SettingsRepository())->load();
+ $controller = new CallbackController(
+ $settings,
+ $shopContext->orderCurrency(),
+ $shopContext->cms(),
+ new OrderRepository(),
+ new OperationRepository($database),
+ new MysqlOrderLock($database),
+ new HostReceiptSource($settings, $database, $logger),
+ $logger,
+ new ThrottledLogger($logger, new MysqlLogThrottle($database))
+ );
+ // (GET POST) MONETA.RU , POST.
+ $response = $controller->handle(CallbackController::requestFields($_GET, $_POST));
+} catch (\Throwable $exception) {
+ $logger->error(' : ' . get_class($exception) . ': ' . $exception->getMessage());
+ $response = CallbackResponse::fail();
+}
+
+moneta_callback_send($response);
diff --git a/moneta/payment/result.php b/moneta/payment/result.php
new file mode 100644
index 0000000..e3c4454
--- /dev/null
+++ b/moneta/payment/result.php
@@ -0,0 +1,7 @@
+
+
+
+
diff --git a/moneta/templates/moneta.css b/moneta/templates/moneta.css
new file mode 100644
index 0000000..0bac882
--- /dev/null
+++ b/moneta/templates/moneta.css
@@ -0,0 +1,168 @@
+/* (templates/payment_forma.tpl).
+ , Bootstrap : PHPShop Bootstrap 3 4/5. */
+.moneta-checkout {
+ max-width: 30rem;
+ margin: 1rem auto;
+ padding: 1.5rem;
+ border: 1px solid #dee2e6;
+ border-radius: 1.25rem;
+ background: #fff;
+ text-align: left;
+}
+
+.moneta-checkout-brand {
+ display: inline-block;
+ margin-bottom: 1.25rem;
+}
+
+.moneta-checkout-logo {
+ display: block;
+ height: 36px;
+ width: auto;
+ max-width: 100%;
+}
+
+.moneta-checkout-info {
+ margin: 0 0 1rem;
+}
+
+.moneta-checkout-total {
+ display: flex;
+ flex-wrap: wrap;
+ align-items: baseline;
+ justify-content: space-between;
+ gap: 0.25rem 1rem;
+ margin-bottom: 1.5rem;
+ padding: 1.25rem 0;
+ border-top: 1px solid #dee2e6;
+ border-bottom: 1px solid #dee2e6;
+}
+
+.moneta-checkout-total-label {
+ color: #6c757d;
+ font-size: 1.125rem;
+}
+
+.moneta-checkout-cost {
+ margin-left: auto;
+ font-size: 2rem;
+ font-weight: 700;
+ line-height: 1.2;
+ white-space: nowrap;
+}
+
+.moneta-checkout .moneta-payment-button {
+ display: block;
+ width: 100%;
+ padding: 0.75rem 1rem;
+ border-radius: 0.75rem;
+ font-size: 1.125rem;
+ font-weight: 600;
+}
+
+.moneta-checkout-note {
+ display: flex;
+ align-items: flex-start;
+ gap: 0.5rem;
+ margin-top: 1.25rem;
+ color: #6c757d;
+ font-size: 0.875rem;
+}
+
+.moneta-checkout-lock {
+ flex-shrink: 0;
+ margin-top: 0.2em;
+}
+
+/* : hidden (Bootstrap 3) d-none (4/5) . */
+.moneta-checkout .moneta-hide {
+ display: none;
+}
+
+@media (max-width: 575.98px) {
+ .moneta-checkout {
+ padding: 1.25rem;
+ }
+
+ .moneta-checkout-cost {
+ font-size: 1.5rem;
+ }
+}
+
+/* /moneta/ (templates/return_forma.tpl): , ,
+ 1-. */
+.moneta-result {
+ max-width: 40rem;
+ margin: 2rem auto 3rem;
+ padding: 0 1rem;
+ text-align: center;
+}
+
+.moneta-result-icon {
+ margin-bottom: 1.5rem;
+}
+
+.moneta-result-icon svg {
+ display: none;
+ margin: 0 auto;
+}
+
+.moneta-result--success .moneta-result-icon-success,
+.moneta-result--error .moneta-result-icon-error,
+.moneta-result--wait .moneta-result-icon-wait,
+.moneta-result--info .moneta-result-icon-info,
+.moneta-result--warning .moneta-result-icon-warning {
+ display: block;
+}
+
+.moneta-result-spinner {
+ animation: moneta-spin 1.2s linear infinite;
+}
+
+@keyframes moneta-spin {
+ to {
+ transform: rotate(360deg);
+ }
+}
+
+.moneta-result-title {
+ margin: 0 0 0.75rem;
+ font-size: 1.75rem;
+ font-weight: 700;
+ line-height: 1.3;
+}
+
+.moneta-result-text {
+ margin: 0 0 2rem;
+ color: #555;
+ font-size: 1.0625rem;
+ line-height: 1.5;
+}
+
+.moneta-result-buttons {
+ display: flex;
+ flex-wrap: wrap;
+ justify-content: center;
+ gap: 0.75rem;
+}
+
+.moneta-result-buttons .btn {
+ flex: 1 1 12rem;
+ max-width: 16rem;
+ padding: 0.625rem 1.25rem;
+ border-radius: 0.5rem;
+}
+
+.moneta-result .moneta-hide {
+ display: none;
+}
+
+@media (max-width: 575.98px) {
+ .moneta-result-title {
+ font-size: 1.375rem;
+ }
+
+ .moneta-result-buttons .btn {
+ max-width: none;
+ }
+}
diff --git a/moneta/templates/moneta.svg b/moneta/templates/moneta.svg
new file mode 100644
index 0000000..39f4c07
--- /dev/null
+++ b/moneta/templates/moneta.svg
@@ -0,0 +1,9 @@
+
diff --git a/moneta/templates/payment_forma.tpl b/moneta/templates/payment_forma.tpl
new file mode 100644
index 0000000..fdfa9df
--- /dev/null
+++ b/moneta/templates/payment_forma.tpl
@@ -0,0 +1,16 @@
+
+
+
+ 
+
+
@payment_info@
+
+
+ @moneta_total@
+
+ @payment_forma@
+
+
+
+
@monetaReturnTitle@
+
@monetaReturnText@
+
+