Что делает пакет
- Создаёт пространство имён utopay и системные настройки utopay_* (ключ, валюта, курс, монета…) с описаниями на русском и английском.
- С miniShop2: регистрирует платёжные классы и создаёт два выключенных способа оплаты — «Карта, Apple Pay, Google Pay, PayPal» (класс Utopay) и «Криптовалюта: USDT, USDC» (класс UtopayCrypto).
- С miniShop3 (MODX 3): создаёт те же два способа с провайдером
Utopay\MiniShop3\UtopayPayment, который работает с попытками оплаты miniShop3 и его маршрутом вебхуков. - После оформления покупатель уходит на страницу UTOPAY; заказ становится оплаченным, только когда платёж, перечитанный через API, совпал по сумме и валюте.
- При обновлении ваши настройки сохраняются; при удалении способы выключаются, заказы не трогаются.
Установка
- Скачайте пакет выше (не переименовывайте файл
utopay-1.1.0-pl.transport.zip). - Менеджер MODX → Пакеты → Установщик → стрелка у «Загрузить дополнения» → Загрузить пакет → выберите файл → Установить.
- Система → Системные настройки → пространство имён utopay: заполните utopay_secret_key — создайте тестовый ключ
utopay_sk_test_…в личном кабинете UTOPAY (Integration → API keys). Если цены не в USD, укажите валюту и курс. - miniShop2 / miniShop3 → Настройки → Способы оплаты: включите «Карта, Apple Pay, Google Pay, PayPal» и/или «Криптовалюта: USDT, USDC» и привяжите к доставкам.
- Для криптовалюты добавьте EVM-кошелёк в кабинете (Project settings → Funds & payouts) и задайте utopay_coin.
- Оформите тестовый заказ, нажмите в песочнице UTOPAY зелёную кнопку ✅ — заказ станет оплаченным. Замените ключ на
utopay_sk_live_….
Настройки
| Системная настройка | Что делает |
|---|---|
| utopay_secret_key | utopay_sk_test_… / utopay_sk_live_…. |
| utopay_currency, utopay_rate | Валюта, в которой списывает UTOPAY, и фиксированный курс из ваших цен (1, если цены уже в ней). |
| utopay_shop_currency | Только miniShop3: валюта цен, в ней хранятся попытки оплаты. |
| utopay_coin | Монета криптоспособа, например bep20/usdt. |
| utopay_provider | Необязательно: сразу вести к Stripe, PayPal, Revolut… |
| utopay_ms2_paid_status, utopay_success_id | Статус оплаты miniShop2 (2) и ресурс, куда возвращается покупатель. |
Как подтверждаются заказы
Каждый платёж создаётся со своим адресом уведомлений, в котором номер заказа, сумма и валюта подписаны вашим секретным ключом. UTOPAY подписывает каждое событие (HMAC-SHA256) и повторяет отправку шесть часов.
Платёж всегда перечитывается через API UTOPAY; заказ становится оплаченным только при точном совпадении суммы и валюты. Недоплата и расхождения пишутся в журнал ошибок MODX с префиксом [UTOPAY].
История версий
- 1.1.0-pl — установочный пакет для установщика MODX: пространство имён, системные настройки, способы оплаты создаются сами.
- 1.0.0 — первый выпуск в виде файлов: miniShop2 (MODX 2.8 – 3.x) и miniShop3 1.14 beta.
SHA-256: 4c3b62e6f9d3dab65ad40b9610b463f40b78327eff0ec5aaabed77fac64a3a2a
Обновлено · Команда интеграций UTOPAY