Что умеет плагин
- UTOPAY — карты и PayPal: карты, Apple Pay, Google Pay, PayPal, Revolut, банковские переводы. Покупатель платит на странице UTOPAY и возвращается на страницу «Спасибо за заказ».
- UTOPAY — криптовалюта: покупатель выбирает монету (USDT и USDC в сетях BNB Chain, Ethereum, Polygon, Arbitrum, Base…; ETH, BNB) прямо при оформлении и получает адрес и точную сумму.
- Заказ становится оплаченным, только когда плагин перечитал платёж через API, а сумма и валюта совпали.
- Если покупатель перевёл меньше криптовалюты, заказ уходит в статус На удержании с пометкой: деньги уже на вашем кошельке, решение за вами.
- Неоплаченный платёж истекает через 24 часа; сам заказ WooCommerce отменит по своему таймеру резерва товара.
Установка
- Скачайте ZIP выше. Распаковывать не нужно.
- Админка WordPress → Плагины → Добавить новый → Загрузить плагин → выберите файл → Установить → Активировать.
- В личном кабинете UTOPAY откройте Integration → API keys и создайте тестовый секретный ключ
utopay_sk_test_…. - WooCommerce → Настройки → Платежи → UTOPAY — карты и PayPal → вставьте ключ → отметьте Включить → Сохранить. Ключ проверяется при сохранении.
- Для криптовалюты: в кабинете добавьте кошельки в Project settings → Funds & payouts, раздел Crypto wallets (один EVM-адрес подходит для всех EVM-сетей), затем включите UTOPAY — криптовалюта и выберите монеты.
Настройки
| Поле | Что делает |
|---|---|
| Секретный ключ | utopay_sk_test_… для песочницы, utopay_sk_live_… для реальных платежей. Общий для обоих способов. |
| Название / Описание | Что покупатель видит при оформлении заказа. |
| Способ оплаты на стороне UTOPAY | Пусто — выбирает покупатель. Или ведите всех сразу к одному способу (Stripe, PayPal, Revolut…); если он недоступен, покажется выбор способов. |
| Монеты | Только у криптоспособа: монеты, которые предлагаются при оформлении. Включайте только сети, для которых в кабинете указан ваш кошелёк. |
| Журнал отладки | Пишет запросы и уведомления в WooCommerce → Статус → Журналы, источник utopay. |
Тестовый платёж
- С тестовым ключом оформите заказ и выберите способ UTOPAY.
- Откроется песочница UTOPAY. Нажмите зелёную кнопку ✅ — оплата будет симулирована.
- Через полторы секунды вы вернётесь на страницу «Спасибо за заказ», заказ перейдёт в Обработку с заметкой «Платёж UTOPAY ord_test_… получен (test)».
- Повторите с красной кнопкой ❌ — заказ станет Неудавшимся.
- Замените ключ на
utopay_sk_live_…. Готово.
Как подтверждаются заказы
Каждый платёж создаётся со своим адресом уведомлений: https://ваш-сайт/?wc-api=utopay&order_id=…&key=…. UTOPAY отправляет туда каждое изменение статуса с подписью HMAC-SHA256 (ключ подписи выводится из вашего секретного ключа). Если сайт не ответил 2xx, UTOPAY повторит через 30 с, 2 мин, 15 мин, 1 ч и 6 ч.
Плагин не доверяет телу уведомления: он запрашивает платёж через API и завершает заказ, только если платёж относится к этому заказу, а сумма и валюта совпадают. Когда покупатель возвращается на страницу «Спасибо за заказ», та же проверка выполняется ещё раз — поэтому заказы подтверждаются даже на локальном или закрытом сайте.
Если что-то не работает
- Способы не видны при оформлении — валюта магазина не поддерживается или ключ пустой. Поддерживаются: USD EUR GBP CAD AUD NZD CHF SEK NOK DKK PLN CZK HUF TRY UAH INR JPY SGD HKD AED MYR THB PHP IDR BRL MXN COP ZAR NGN.
- «Не удалось начать оплату: amount is below the minimum» — сумма заказа меньше минимума выбранного способа или монеты; покупатель может выбрать другой.
- Заказ остаётся «В ожидании оплаты» — сайт должен быть доступен из интернета без HTTP-авторизации, а плагины безопасности не должны блокировать POST-запросы на
/?wc-api=utopay. Включите Журнал отладки и найдите строкиcallback. - «no evm wallet…» — монета включена в плагине, но в кабинете нет кошелька для её сети.
История версий
- 1.0.2 — обновлено общее ядро UTOPAY, поведение не изменилось.
- 1.0.1 — поддержка white-label домена API (константа UTOPAY_API_BASE); монеты по умолчанию — в EVM-сетях.
- 1.0.0 — первый выпуск: карты и PayPal, криптовалюта, блочный чекаут, HPOS, русский перевод.
SHA-256: 8a3900be6f724ca8c467fa538aeaedb9c81a6789dd59840313767688e1ffcf1b
Обновлено · Команда интеграций UTOPAY