Що робить пакет
- Створює простір імен utopay і системні налаштування utopay_* (ключ, валюта, курс, монета…) з описами англійською й російською.
- З miniShop2: реєструє платіжні класи й створює два вимкнені способи оплати — «Card, Apple Pay, Google Pay, PayPal» (клас Utopay) і «Crypto: USDT, USDC» (клас UtopayCrypto).
- З miniShop3 (MODX 3): створює ті самі два способи з провайдером
Utopay\MiniShop3\UtopayPayment, який працює зі спробами оплати miniShop3 і його маршрутом вебхуків. - Після оформлення покупець переходить на сторінку UTOPAY; замовлення стає оплаченим, лише коли платіж, перечитаний через API, збігся за сумою й валютою.
- Під час оновлення ваші налаштування зберігаються; під час видалення способи вимикаються, замовлення не зачіпаються.
Встановлення
- Завантажте пакет вище (не перейменовуйте файл
utopay-1.1.0-pl.transport.zip). - Менеджер MODX → Extras → Installer → стрілка біля «Download Extras» → Upload a package → оберіть файл → Install.
- System → System Settings → простір імен utopay: заповніть utopay_secret_key — створіть тестовий ключ
utopay_sk_test_…в особистому кабінеті UTOPAY (Integration → API keys). Якщо ціни не в USD, вкажіть валюту й курс. - miniShop2 / miniShop3 → Settings → Payments: увімкніть «Card, Apple Pay, Google Pay, PayPal» та/або «Crypto: 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