Що вміє плагін
- UTOPAY — картки й PayPal: картки, Apple Pay, Google Pay, PayPal, Revolut, банківські перекази. Покупець платить на сторінці UTOPAY і повертається на сторінку «Дякуємо».
- UTOPAY — криптовалюта: покупець обирає монету (USDT і USDC у BNB Chain, Ethereum, Polygon, Arbitrum, Base…; ETH, BNB) прямо під час оформлення й отримує адресу з точною сумою.
- Замовлення позначається оплаченим лише після того, як плагін перечитав платіж через API, а сума й валюта збіглися.
- Замовлення з недоплатою криптовалютою переходить у On hold з приміткою: гроші вже на вашому гаманці, рішення за вами.
- Неоплачені платежі спливають через 24 години; WooCommerce скасовує замовлення за власним таймером резерву товару.
Встановлення
- Завантажте ZIP вище. Розпаковувати не потрібно.
- Адмінка WordPress → Plugins → Add New → Upload Plugin → оберіть файл → Install Now → Activate.
- В особистому кабінеті UTOPAY відкрийте Integration → API keys і створіть тестовий секретний ключ
utopay_sk_test_…. - WooCommerce → Settings → Payments → UTOPAY — cards & PayPal → вставте ключ → позначте Enable → Save. Ключ перевіряється під час збереження.
- Для криптовалюти: у кабінеті додайте гаманці в Project settings → Funds & payouts, розділ Crypto wallets (одна EVM-адреса підходить для всіх EVM-мереж), потім увімкніть UTOPAY — crypto й оберіть монети.
Налаштування
| Поле | Що робить |
|---|---|
| Secret key | utopay_sk_test_… для пісочниці, utopay_sk_live_… для реальних платежів. Спільний для обох способів. |
| Title / Description | Що покупець бачить під час оформлення замовлення. |
| Payment method on the UTOPAY side | Порожньо — обирає покупець. Або ведіть усіх одразу до одного способу (Stripe, PayPal, Revolut…); якщо він недоступний, з’явиться вибір способів. |
| Coins | Лише для криптоспособу: монети, які пропонуються під час оформлення. Вмикайте лише мережі, для яких у кабінеті вказано ваш гаманець. |
| Debug log | Пише запити й сповіщення в WooCommerce → Status → Logs, джерело utopay. |
Тестовий платіж
- З тестовим ключем оформіть замовлення й оберіть спосіб UTOPAY.
- Відкриється пісочниця UTOPAY. Натисніть зелену кнопку ✅ — оплату буде симульовано.
- Через півтори секунди ви повернетеся на сторінку «Дякуємо», замовлення перейде в Processing з приміткою «UTOPAY payment ord_test_… received (test)».
- Повторіть із червоною кнопкою ❌ — замовлення стане Failed.
- Замініть ключ на
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.
- «Payment could not be started: amount is below the minimum» — сума замовлення менша за мінімум обраного способу чи монети; покупець може обрати інший.
- Замовлення залишається «Pending payment» — сайт має бути доступний з інтернету без HTTP-авторизації, а плагіни безпеки не повинні блокувати POST-запити на
/?wc-api=utopay. Увімкніть Debug log і знайдіть рядки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