iPay.ua для WooCommerce — оплата карткою через інтернет-еквайринг

iPay.ua для WooCommerce — платіжний плагін, який приймає оплату карткою через інтернет-еквайринг iPay.ua (Checkout API). Покупець переходить на захищену сторінку iPay.ua, платить карткою Visa або Mastercard, а замовлення в магазині підтверджується само. Плагін не вірить сповіщенню на слово: на кожне він окремо питає в iPay.ua статус платежу й звіряє суму, тож підробленим запитом замовлення «оплатити» не вийде.

Базова версія — безкоштовна. Приймання оплати, автопідтвердження, фонова звірка статусу й пісочниця працюють без ліцензії й без обмеження в часі. Pro додає повернення коштів з картки замовлення, списання й розблокування предавторизованих платежів, фіскальні чеки через iPay.ua і журнал платежів.

Як це виглядає для покупця

Якщо оплата не пройшла, покупець натискає «Повернутися на сайт» і бачить сторінку оплати замовлення з поясненням і можливістю спробувати ще раз або обрати інший спосіб. Замовлення при цьому не губиться.

Що отримує адмін

• «Перевірити доступи» — плагін надсилає підписаний запит статусу неіснуючого платежу. Правильні доступи iPay.ua підтверджує, неправильні відхиляє, а жоден платіж при цьому не створюється.
• Пісочниця на sandbox-checkout.ipay.ua з тестовими картками з документації iPay.ua — інтеграцію перевіряєте до того, як рухаються реальні гроші.
• URL для сповіщень показується внизу налаштувань — його треба один раз передати менеджеру iPay.ua, бо адресу сповіщень iPay.ua прописує на своєму боці.
• Статус після оплати на ваш вибір: «В обробці» або одразу «Виконано».

Як це працює — крок за кроком

1. Покупець на чекауті обирає «Оплата карткою (iPay.ua)» і підтверджує замовлення.
2. Плагін створює платіж в iPay.ua (PaymentCreate) з сумою в копійках, описом «Замовлення №…», унікальним ext_id і посиланнями повернення. Запит підписується вашим ключем за алгоритмом HMAC-SHA512.
3. Покупець платить на захищеній сторінці iPay.ua. Дані картки не проходять через ваш сайт.
4. iPay.ua надсилає сповіщення. Плагін перевіряє підпис, а потім окремим запитом Status питає в iPay.ua реальний стан платежу — і вже за ним змінює замовлення. Сума з iPay.ua звіряється із сумою замовлення: якщо сплачено менше, замовлення стає «На утриманні» з нотаткою.
5. Покупець повертається в магазин — статус звіряється ще раз, тож «Замовлення отримано» показується лише коли гроші справді надійшли.
6. Фонова звірка кожні 10 хвилин підтягує оплати, про які сповіщення не дійшло: наприклад, поки iPay.ua ще не підключив ваш URL сповіщень.
7. З Pro повернення робиться прямо з картки замовлення: у день оплати — скасуванням (Reversal), у наступні дні — поверненням (Refund), повним або частковим.

Скільки коштує

890 грн — ліцензія на рік. Рік оновлень, технічної підтримки та всіх Pro-функцій.

Можна одразу взяти довший термін — що довший, то дешевше за рік:

• 1 рік — 890 грн
• 2 роки — 1 690 грн (−5%, по 845 грн за рік)
• 3 роки — 2 350 грн (−12%, по 783 грн за рік)
• 4 роки — 2 920 грн (−18%, по 730 грн за рік)
• 5 років — 3 340 грн (−25%, по 668 грн за рік)

Автосписань немає: продовження вручну, нагадування приходять на пошту. Коли термін спливає, вимикаються лише Pro-функції, а приймання оплати продовжує працювати.

Один ключ — один домен. Переносите магазин — деактивуйте ліцензію на старому домені й активуйте на новому.

Спершу тріал, потім оплата. 7-денний безкоштовний Pro-тріал вмикається кнопкою в налаштуваннях плагіна, картка не потрібна. Сам тріал не стартує: свіжа установка — чиста Free-версія.

Технічні вимоги

• WooCommerce 6.0+ з класичним або блоковим чекаутом, сумісність з HPOS
• WordPress 6.2+ · PHP 7.4+
• Валюта магазину — гривня. При іншій валюті спосіб оплати ховається сам, і покупця не спишуть на неправильну суму.
• Договір з iPay.ua і доступи до Checkout API: mch_id та sign_key. Тестові доступи для пісочниці теж видає iPay.ua.
• Для предавторизації — увімкнений у iPay.ua режим предавторизації для вашого мерчанта. Для фіскальних чеків — касир і каса, підключені в iPay.ua. Для повернень у наступні дні — доступ до Refund, який iPay.ua надає за згодою.

Що під капотом

• Сповіщення — лише тригер. Підпис Checkout API покриває тільки «сіль», а не вміст сповіщення, тому плагін ніколи не бере статус з тіла запиту: замовлення змінюється лише за відповіддю iPay.ua на запит Status. Перехоплене й перероблене сповіщення нічого не оплатить.
• Захист від подвійної оплати. Сповіщення, повернення покупця і фонова звірка можуть прийти в одну секунду — атомарне блокування гарантує одну нотатку «оплату отримано» й одне списання залишків. Кнопка «Назад» після оплати не створює другий платіж.
• Фінальні статуси не відкочуються: пізня відповідь «неуспішний» не зробить оплачене замовлення неоплаченим.
• Ключ підпису зберігається в базі зашифрованим, а повторне збереження налаштувань не псує його, навіть якщо в ключі є спецсимволи.
• Фіскальний чек сходиться до копійки: рядки будуються з підсумків рядків замовлення зі знижками, доставкою й комісіями, а різниця округлення враховується явно.
• Безпечний розбір XML без зовнішніх сутностей і мережевих запитів.
• Pro-гейт без «цегли»: коли тріал або ліцензія закінчились, зупиняються лише Pro-функції, а приймання оплати не ламається.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть ipay-ua-for-woocommerce-1.0.0.zip і активуйте.
2. Відкрийте WooCommerce → Налаштування → Платежі → iPay.ua.
3. Для перевірки увімкніть «Пісочниця» і впишіть тестові Merchant ID та ключ підпису від iPay.ua. Збережіть і натисніть «Перевірити доступи».
4. Скопіюйте URL для сповіщень з низу сторінки налаштувань і надішліть менеджеру iPay.ua.
5. Для реальних оплат вимкніть пісочницю, впишіть бойові Merchant ID і ключ підпису, збережіть і ще раз перевірте доступи.
6. Для Pro: вставте ліцензійний ключ з листа після оплати в поле ліцензії або запустіть 7-денний тріал.

Історія версій

1.0.0 — вересень 2026

Перший реліз: створення платежу iPay.ua з переходом на сторінку оплати, підписані запити HMAC-SHA512, сповіщення з перепровіркою через Status, звірка при поверненні покупця й фонова звірка кожні 10 хвилин, захист від недоплати й подвійної оплати, пісочниця й перевірка доступів, класичний і блоковий чекаут, HPOS, український переклад. Pro: повернення (Reversal / Refund, часткове), предавторизація зі списанням і розблокуванням, фіскальні чеки через iPay.ua, журнал платежів.