Що вміє розширення
- Під час оформлення покупець обирає Картка, Apple Pay, Google Pay, PayPal або Криптовалюта з вибором монети, натискає «Підтвердити» й платить на сторінці UTOPAY.
- Замовлення отримує статус оплати (за замовчуванням Processing) лише після того, як платіж перечитано через API, а сума й валюта збіглися.
- Якщо покупець повернувся до підтвердження (крипта ще йде мережею), замовлення стає видимим зі статусом очікування (за замовчуванням Pending) і пізніше переходить в оплачене.
- У разі недоплати криптовалютою чи розбіжності суми замовлення залишається в статусі очікування з приміткою в історії.
- Спосіб приховується, якщо валюта замовлення не підтримується або в кошику товари з підпискою (4.x).
Встановлення
- Завантажте збірку для своєї версії й розпакуйте: усередині utopay.ocmod.zip і README.txt.
- OpenCart 3.0 і 4.x: Extensions → Installer → Upload → оберіть
utopay.ocmod.zip(у 4.x натисніть ще «Install» поруч). Не перейменовуйте файл: OpenCart 4 бере з назви код розширення. - OpenCart 2.3: розпакуйте
utopay.ocmod.zipі завантажте вміст папкиuploadу корінь магазину через FTP — установнику 2.3 потрібні налаштування FTP. - Extensions → Extensions → Payments → UTOPAY → Install → Edit.
- В особистому кабінеті UTOPAY відкрийте Integration → API keys, створіть тестовий ключ
utopay_sk_test_…і вставте його. Ключ перевіряється під час збереження. - Для криптовалюти додайте EVM-гаманець у кабінеті (Project settings → Funds & payouts) і перелічіть монети.
Налаштування
| Поле | Що робить |
|---|---|
| Secret key | utopay_sk_test_… для пісочниці, utopay_sk_live_… для реальних платежів. |
| Payment options | Картка / PayPal і криптовалюта, лише картка або лише криптовалюта. |
| Crypto coins | Тікери через кому, наприклад bep20/usdt,erc20/usdt,polygon/usdc. |
| Card method | Порожньо — обирає покупець; або одразу Stripe, PayPal, Revolut… |
| Paid order status | Ставиться після підтвердження оплати. За замовчуванням Processing. |
| Awaiting / check status | Ставиться, якщо покупець повернувся до підтвердження або недоплатив криптовалютою. За замовчуванням Pending. |
| Geo zone, status, sort order | Як у будь-якого способу оплати OpenCart. |
Тестовий платіж
- З тестовим ключем оформіть замовлення, оберіть UTOPAY і натисніть Confirm order.
- У пісочниці UTOPAY натисніть зелену кнопку ✅.
- Ви потрапите на сторінку успішного замовлення; замовлення в статусі Processing з приміткою «UTOPAY: payment ord_test_… received (test)».
- Замініть ключ на
utopay_sk_live_….
Як підтверджуються замовлення
Кожен платіж має власну адресу сповіщень, у якій номер замовлення, сума й валюта підписані вашим секретним ключем. UTOPAY підписує кожну подію (HMAC-SHA256) і повторює надсилання шість годин, якщо магазин не відповів 2xx.
Розширення перевіряє обидва підписи, перечитує платіж через API й змінює статус, лише якщо оплачено рівно на запитану суму в потрібній валюті. Оплачене замовлення назад не відкочується.
Якщо щось не працює
- UTOPAY немає під час оформлення — валюта замовлення не підтримується, ключ порожній, спосіб вимкнено або не підходить геозона.
- «amount is below the minimum» — сума менша за мінімум способу чи монети; покупець може обрати інший.
- Замовлення немає в адмінці — покупець пішов, не сплативши; OpenCart зберігає такі замовлення як «втрачені» (фільтр за статусом Missing Orders).
- Замовлення залишається в Pending — магазин має бути доступний з інтернету; шукайте рядки
UTOPAYу System → Maintenance → Error Logs.
Історія версій
- 1.0.0 — перший випуск: OpenCart 2.3 – 3.0 і 4.0 – 4.1, картки й PayPal, криптовалюта, російський переклад.
SHA-256 (2.3 – 3.0): 75fda725c1a514f5723ea19caf8f3fae64dc7c0576b1d3eb17a43d54cc439191
SHA-256 (4.x): bc1e1f62e1da1ca9e5bb1f7c83b59e34804508d2cebc3aa46b5125856c4b65b9
Оновлено · Команда інтеграцій UTOPAY