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

CatCode EasyPay — модуль оплати через EasyPay для OpenCart 2.3, 3.x і 4.x. Покупець платить карткою Visa/Mastercard, Apple Pay або Google Pay на захищеній сторінці EasyPay, а замовлення в магазині саме переходить в оплачений статус. EasyPay надсилає підписане сповіщення, модуль перевіряє підпис, окремо питає в EasyPay статус платежу і звіряє суму. Лише після цього замовлення стає оплаченим, тому підробити оплату запитом на сайт не вийде.

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

У чекауті це звичайний спосіб оплати «Оплата карткою, Apple Pay, Google Pay (EasyPay)». Покупець підтверджує замовлення і тисне «Перейти до оплати». Модуль створює замовлення в EasyPay і відкриває сторінку оплати.

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

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

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

• «Перевірити ключі» надсилає підписаний службовий запит до EasyPay. Помилку модуль називає конкретно: не підходить SecretKey (EasyPay відхиляє підпис) або EasyPay не знає ServiceKey. Про проблему ви дізнаєтеся в адмінці, а не від покупця.
• Окремі статуси замовлення для «очікує оплати», «оплачено», «невдала оплата» і «повернення» — на вкладці «Статуси замовлень».
• Історія замовлення з номером транзакції EasyPay і причиною відмови банку. Недоплату видно одразу: «сплачено 3552.18 грн при сумі замовлення 3553.18 грн — потрібна перевірка», і таке замовлення в оплачені не переходить.
• Журнал платежів (Pro): усі платежі EasyPay одним списком — сума замовлення, сплачено, повернено, стан в EasyPay поруч зі статусом замовлення, номер транзакції і картка. Там же кнопки «Звірити» і «Повернути».

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

1. Покупець підтверджує замовлення з оплатою EasyPay. Модуль створює замовлення в EasyPay: номер спроби, суму, опис, адресу для сповіщень і сторінки повернення. Кожен запит підписується вашим SecretKey. Замовлення отримує статус «очікує оплати».
2. Покупець платить на сторінці EasyPay карткою, Apple Pay або Google Pay.
3. EasyPay надсилає сповіщення на ваш сайт. Модуль перевіряє підпис: непідписаний або підроблений запит отримує відмову, і замовлення лишається як було.
4. Модуль сам питає в EasyPay статус цього платежу запитом orderState. Тіло сповіщення потрібне лише, щоб знайти замовлення.
5. Сума звіряється із сумою замовлення. Якщо все збігається, замовлення стає оплаченим, і в історію записується номер транзакції. Якщо сплачено менше — замовлення лишається на перевірці з нотаткою.
6. Покупець повертається в магазин, і модуль ще раз перевіряє статус. Якщо сповіщення затрималось, замовлення закривається тут. Повторне сповіщення дублем в історії не стає.

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

• Підпис у обидва боки: base64(SHA-256) від SecretKey і тіла запиту, перевірка сповіщень — порівнянням за сталий час. SecretKey зберігається в базі зашифрованим і не показується у формі.
• Статус береться з EasyPay (orderState), а не зі сповіщення. Відмову банку модуль розпізнає навіть тоді, коли EasyPay повертає її разом із блоком помилки, і записує причину в історію замовлення.
• Унікальні номери спроб: номер замовлення плюс випадковий суфікс. Відхилена стара спроба не зачепить уже оплачене замовлення, а оплачена стара спроба зарахується, навіть якщо покупець відкрив нову.
• Запобіжники: пізнє сповіщення не відкотить оплачене замовлення, «Назад» після оплати не створить другий платіж, недоплата не стане оплатою, повторне сповіщення не продублює запис.
• Повернення (Pro) рахуються накопичувально: від’ємна сума, сміття чи сума понад залишок відсікаються ще до запиту в EasyPay, а після повного повернення замовлення отримує статус «Повернено».
• Ядро OpenCart не патчиться: у 4.x модуль ставиться як звичайне розширення, у 3.x і 2.3 — без ocmod-правок. Таблиця платежів при видаленні модуля лишається, історію не втратите.

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

1. OpenCart 4.x: Розширення → Встановлення розширень → завантажте cc_easypay.ocmod.zip і натисніть «Встановити». Далі Розширення → Оплата → «EasyPay — оплата карткою, Apple Pay, Google Pay» → «Встановити» → «Редагувати».
2. OpenCart 3.x: Розширення → Встановлення розширень → завантажте cc_easypay-oc3-1.0.1.ocmod.zip, потім Розширення → Оплата → EasyPay → «Встановити».
3. OpenCart 2.3: штатний інсталятор 2.3 вимагає FTP, тому простіше розпакувати вміст папки upload/ з архіву cc_easypay-oc2-1.0.1.ocmod.zip у корінь магазину. Потім Розширення → Оплата → EasyPay → «Встановити».
4. Для перевірки увімкніть «Тестовий режим» і проведіть замовлення до сторінки оплати EasyPay.
5. Для реальних оплат вимкніть тестовий режим, впишіть PartnerKey, ServiceKey і SecretKey, натисніть «Перевірити ключі» і збережіть. Адресу для сповіщень модуль передає сам з кожним платежем.