Что умеет расширение
- При оформлении покупатель выбирает Карта, Apple Pay, Google Pay, PayPal или Криптовалюта с выбором монеты, нажимает «Подтвердить» и платит на странице UTOPAY.
- Заказ получает статус оплаты (по умолчанию «Обработка») только после того, как платёж перечитан через API, а сумма и валюта совпали.
- Если покупатель вернулся до подтверждения (крипта ещё идёт по сети), заказ становится виден со статусом ожидания (по умолчанию «Ожидание») и позже переходит в оплаченный.
- При недоплате криптовалюты или несовпадении суммы заказ остаётся в статусе ожидания с пометкой в истории.
- Способ скрывается, если валюта заказа не поддерживается или в корзине товары с подпиской (4.x).
Установка
- Скачайте сборку для своей версии и распакуйте: внутри utopay.ocmod.zip и README.txt.
- OpenCart 3.0 и 4.x: Модули → Установка расширений → Загрузить → выберите
utopay.ocmod.zip(в 4.x нажмите ещё «Установить» рядом с ним). Не переименовывайте файл: OpenCart 4 берёт из имени код расширения. - OpenCart 2.3: распакуйте
utopay.ocmod.zipи загрузите содержимое папкиuploadв корень магазина по FTP — установщику 2.3 нужны настройки FTP. - Модули → Модули → Оплата → UTOPAY → Установить → Редактировать.
- В личном кабинете UTOPAY откройте Integration → API keys, создайте тестовый ключ
utopay_sk_test_…и вставьте его. Ключ проверяется при сохранении. - Для криптовалюты добавьте EVM-кошелёк в кабинете (Project settings → Funds & payouts) и перечислите монеты.
Настройки
| Поле | Что делает |
|---|---|
| Секретный ключ | utopay_sk_test_… для песочницы, utopay_sk_live_… для реальных платежей. |
| Способы оплаты | Карта / PayPal и криптовалюта, только карта или только криптовалюта. |
| Монеты | Тикеры через запятую, например bep20/usdt,erc20/usdt,polygon/usdc. |
| Способ для карт | Пусто — выбирает покупатель; или сразу Stripe, PayPal, Revolut… |
| Статус оплаченного заказа | Ставится после подтверждения оплаты. По умолчанию «Обработка». |
| Статус «ожидает / проверить» | Ставится, если покупатель вернулся до подтверждения или недоплатил криптой. По умолчанию «Ожидание». |
| Геозона, статус, порядок | Как у любого способа оплаты OpenCart. |
Тестовый платёж
- С тестовым ключом оформите заказ, выберите UTOPAY и нажмите Подтвердить заказ.
- В песочнице UTOPAY нажмите зелёную кнопку ✅.
- Вы попадёте на страницу успешного заказа; заказ в статусе Обработка с пометкой «UTOPAY: payment ord_test_… received (test)».
- Замените ключ на
utopay_sk_live_….
Как подтверждаются заказы
Каждый платёж создаётся со своим адресом уведомлений, в котором номер заказа, сумма и валюта подписаны вашим секретным ключом. UTOPAY подписывает каждое событие (HMAC-SHA256) и повторяет отправку шесть часов, если магазин не ответил 2xx.
Расширение проверяет обе подписи, перечитывает платёж через API и меняет статус, только если оплачено ровно на запрошенную сумму в нужной валюте. Оплаченный заказ назад не откатывается.
Если что-то не работает
- UTOPAY нет при оформлении — валюта заказа не поддерживается, ключ пустой, способ выключен или не подходит геозона.
- «amount is below the minimum» — сумма меньше минимума способа или монеты; покупатель может выбрать другой.
- Заказа нет в админке — покупатель ушёл, не оплатив; OpenCart хранит такие заказы как «потерянные» (фильтр по статусу Missing Orders).
- Заказ остаётся в «Ожидании» — магазин должен быть доступен из интернета; ищите строки
UTOPAYв Система → Обслуживание → Журнал ошибок.
История версий
- 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