Що вміє модуль
- Під час оформлення видно Картка, Apple Pay, Google Pay, PayPal і Криптовалюта (з вибором монети). Будь-який спосіб можна вимкнути.
- Замовлення створюється в статусі Awaiting UTOPAY payment, потім покупець платить на сторінці UTOPAY.
- Коли платіж перечитано через API, а сума й валюта збіглися, замовлення переходить у Payment accepted; номер платежу UTOPAY зберігається як номер транзакції.
- Сторінка підтвердження замовлення ще раз перевіряє платіж і показує Сплатити знову, поки замовлення не оплачене.
- Недоплата криптовалютою й розбіжність суми пишуться в Advanced Parameters → Logs по замовленню.
Встановлення
- Завантажте ZIP вище.
- Modules → Module Manager → Upload a module → оберіть ZIP (PrestaShop 1.6: Modules → Add a new module).
- Відкрийте Configure. В особистому кабінеті UTOPAY створіть тестовий ключ
utopay_sk_test_…(Integration → API keys) і вставте його. Ключ перевіряється під час збереження. - Оберіть способи оплати й монети. Для криптовалюти додайте EVM-гаманець у кабінеті (Project settings → Funds & payouts).
- Перевірте, що модуль дозволений для ваших валют і країн у Payment → Preferences.
Налаштування
| Поле | Що робить |
|---|---|
| Secret key | utopay_sk_test_… для пісочниці, utopay_sk_live_… для реальних платежів. Порожнє поле — залишити збережений ключ. |
| Payment options | Картка / PayPal і криптовалюта, лише картка або лише криптовалюта. |
| Crypto coins | Тікери через кому, наприклад bep20/usdt,erc20/usdt,polygon/usdc. |
| Card method | Порожньо — обирає покупець; або одразу Stripe, PayPal, Revolut… |
Тестовий платіж
- З тестовим ключем оформіть замовлення й оберіть спосіб UTOPAY.
- У пісочниці UTOPAY натисніть зелену кнопку ✅.
- Ви повернетеся на сторінку підтвердження: «Оплату отримано». В адмінці замовлення в статусі Payment accepted.
- Замініть ключ на
utopay_sk_live_….
Як підтверджуються замовлення
Кожен платіж має власну адресу сповіщень (/module/utopay/callback), у якій номер замовлення, сума й валюта підписані вашим секретним ключем. UTOPAY підписує кожну подію (HMAC-SHA256) і повторює надсилання шість годин, якщо магазин не відповів 2xx.
Модуль перевіряє обидва підписи, перечитує платіж через API й ставить Payment accepted, лише якщо оплачено рівно на суму замовлення в його валюті.
Якщо щось не працює
- UTOPAY немає під час оформлення — валюта кошика не підтримується, ключ порожній або модуль не дозволений для валюти / країни в Payment → Preferences.
- Замовлення залишаються в «Awaiting UTOPAY payment» — магазин має бути доступний з інтернету, режим обслуговування вимкнено; дивіться Advanced Parameters → Logs.
- «amount is below the minimum» — сума менша за мінімум способу чи монети; покупець може натиснути Сплатити знову й обрати інший.
Історія версій
- 1.0.0 — перший випуск: PrestaShop 1.6.1 – 9, картки й PayPal, криптовалюта, «Сплатити знову», російський переклад.
SHA-256: 3fbdc9540feaa15a12ca677af2c56d55284f104a119c50bc139fe20e1248ac52
Оновлено · Команда інтеграцій UTOPAY