iPay.ua для OpenCart — оплата карткою, Apple Pay і Google Pay

CatCode iPay — модуль оплати через iPay.ua для OpenCart 2.3, 3.x і 4.x. Покупець платить карткою, Apple Pay або Google Pay на захищеній сторінці iPay, а замовлення в магазині саме переходить в «Оплачено». Статус модуль бере не зі слів сповіщення, а з відповіді API iPay на ваші ключі, тому підробити оплату запитом на сайт не вийде.

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

У чекауті це звичайний спосіб оплати «Оплата карткою, Apple Pay, Google Pay (iPay.ua)». Покупець підтверджує замовлення, модуль створює платіж в iPay і веде його на сторінку оплати з сумою в гривнях і назвою вашого магазину. Сторінка відкривається мовою магазину: українською, російською або англійською.

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

Модуль показується лише для кошика в гривнях. Якщо покупець перемкнув валюту магазину на долари чи євро, спосіб оплати ховається: iPay списав би ту саму цифру в гривнях.

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

• Перевірка ключів однією кнопкою. Модуль робить службовий запит до iPay і каже, чи прийнято ID мерчанта й ключ підпису. Платіж при цьому не створюється.
• Окремі статуси замовлення для «очікує оплати», «оплачено», «кошти заблоковано», «оплата не пройшла» і «повернення».
• Історія замовлення з номером платежу iPay і замаскованою карткою. Недоплату видно одразу: «сплачено 3969.85 грн замість 3979.85 грн — потрібна перевірка», і таке замовлення в оплачені не переходить.
• Журнал платежів (Pro): усі платежі iPay одним списком, зі статусом в iPay поруч зі статусом замовлення. Там же кнопки «Звірити», «Повернути», «Списати» і «Скасувати блокування».

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

1. Покупець підтверджує замовлення з оплатою iPay. Модуль створює платіж запитом PaymentCreate: сума в копійках, опис «Оплата замовлення №…», адреси повернення, мова сторінки. Замовлення отримує статус «очікує оплати».
2. Покупець платить на сторінці iPay карткою, Apple Pay чи Google Pay.
3. iPay надсилає нотифікацію на ваш сайт. Модуль знаходить за номером платежу своє замовлення і питає в iPay справжній статус запитом Status, зі своїми ключами.
4. Модуль звіряє оплачену суму із сумою замовлення. Якщо все збігається, замовлення стає «Оплачено», і в історію записується номер платежу й картка.
5. Покупець повертається в магазин. Модуль ще раз питає статус: якщо нотифікація не дійшла, замовлення закривається тут. Повторна нотифікація дублем у історії не стає.
6. Якщо iPay підключив вам предавторизацію, кошти спершу лише блокуються. У Pro вони списуються автоматично, щойно менеджер переводить замовлення в оплачений статус. Або вручну з журналу: «Списати» чи «Скасувати блокування».

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

iPay підписує запити й нотифікації так: сіль плюс HMAC-SHA512 від солі ключем мерчанта. Сам вміст повідомлення цей підпис не покриває. Тому модуль нікому не вірить на слово: підпис нотифікації перевіряється, але замовлення змінює лише відповідь запиту Status, який модуль сам робить до iPay з вашими ключами. Підроблена чи перехоплена нотифікація може хіба що змусити модуль ще раз перевірити статус.

Далі стоять запобіжники, які ми зазвичай ловимо на чужих платіжних модулях. Пізня нотифікація не відкотить оплачене замовлення назад. Натиснута «Назад» після оплати не створить другий платіж. Замовлення, що вже пішло далі статусу 0, не піде в банк зі старою сумою. Недоплата не стане оплатою. Повне повернення в день оплати йде операцією reversal, пізніше — refund. Часткові повернення рахуються накопичувально, і вийти за залишок не можна.

Ключ підпису зберігається в базі в зашифрованому вигляді. Ядро OpenCart не патчиться: у 4.x і 3.x усе працює через штатні події, у 2.3 — теж без ocmod-правок. Таблиця платежів і налаштування при видаленні модуля лишаються, історію не втратите.

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

1. OpenCart 4.x: Розширення → Встановлення розширень → завантажте cc_ipay.ocmod.zip і натисніть «Встановити». Далі Розширення → Оплата → «iPay.ua — оплата карткою (CatCode)» → «Встановити» → «Редагувати».
2. OpenCart 3.x: Розширення → Встановлення розширень → завантажте cc-ipay-oc3-1.0.1.ocmod.zip, потім Розширення → Оплата → iPay → «Встановити».
3. OpenCart 2.3: штатний інсталятор 2.3 вимагає FTP, тому простіше розпакувати вміст папки upload/ з архіву cc-ipay-oc2-1.0.1.ocmod.zip у корінь магазину. Потім Розширення → Оплата → iPay → «Встановити».
4. Уведіть ID мерчанта й ключ підпису, натисніть «Перевірити ключі», збережіть і надішліть URL нотифікацій у підтримку iPay.
5. Для початку увімкніть «Пісочницю» і проведіть тестову оплату карткою 3333 3333 3333 3331.