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

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

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

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

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

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