Что умеет модуль
- При оформлении видны Карта, Apple Pay, Google Pay, PayPal и Криптовалюта (с выбором монеты). Любой способ можно выключить.
- Заказ создаётся в статусе Ожидает оплаты UTOPAY, затем покупатель платит на странице UTOPAY.
- Когда платёж перечитан через API, а сумма и валюта совпали, заказ переходит в Платёж принят; номер платежа UTOPAY сохраняется как номер транзакции.
- Страница подтверждения заказа ещё раз проверяет платёж и показывает Оплатить снова, пока заказ не оплачен.
- Недоплата криптовалюты и несовпадение суммы пишутся в Расширенные параметры → Журнал по заказу.
Установка
- Скачайте ZIP выше.
- Модули → Менеджер модулей → Загрузить модуль → выберите ZIP (PrestaShop 1.6: Модули → Добавить новый модуль).
- Откройте Настроить. В личном кабинете UTOPAY создайте тестовый ключ
utopay_sk_test_…(Integration → API keys) и вставьте его. Ключ проверяется при сохранении. - Выберите способы оплаты и монеты. Для криптовалюты добавьте EVM-кошелёк в кабинете (Project settings → Funds & payouts).
- Проверьте, что модуль разрешён для ваших валют и стран в Оплата → Настройки.
Настройки
| Поле | Что делает |
|---|---|
| Секретный ключ | utopay_sk_test_… для песочницы, utopay_sk_live_… для реальных платежей. Пустое поле — оставить сохранённый ключ. |
| Способы оплаты | Карта / PayPal и криптовалюта, только карта или только криптовалюта. |
| Монеты | Тикеры через запятую, например bep20/usdt,erc20/usdt,polygon/usdc. |
| Способ для карт | Пусто — выбирает покупатель; или сразу Stripe, PayPal, Revolut… |
Тестовый платёж
- С тестовым ключом оформите заказ и выберите способ UTOPAY.
- В песочнице UTOPAY нажмите зелёную кнопку ✅.
- Вы вернётесь на страницу подтверждения: «Оплата получена». В админке заказ в статусе Платёж принят.
- Замените ключ на
utopay_sk_live_….
Как подтверждаются заказы
Каждый платёж создаётся со своим адресом уведомлений (/module/utopay/callback), в котором номер заказа, сумма и валюта подписаны вашим секретным ключом. UTOPAY подписывает каждое событие (HMAC-SHA256) и повторяет отправку шесть часов, если магазин не ответил 2xx.
Модуль проверяет обе подписи, перечитывает платёж через API и ставит Платёж принят, только если оплачено ровно на сумму заказа в его валюте.
Если что-то не работает
- UTOPAY нет при оформлении — валюта корзины не поддерживается, ключ пустой или модуль не разрешён для валюты / страны в Оплата → Настройки.
- Заказы остаются в «Ожидает оплаты UTOPAY» — магазин должен быть доступен из интернета, режим обслуживания выключен; смотрите Расширенные параметры → Журнал.
- «amount is below the minimum» — сумма меньше минимума способа или монеты; покупатель может нажать Оплатить снова и выбрать другой.
История версий
- 1.0.0 — первый выпуск: PrestaShop 1.6.1 – 9, карты и PayPal, криптовалюта, «Оплатить снова», русский перевод.
SHA-256: 3fbdc9540feaa15a12ca677af2c56d55284f104a119c50bc139fe20e1248ac52
Обновлено · Команда интеграций UTOPAY