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, нажмите «Проверить ключи» и сохраните. Адрес для уведомлений модуль передаёт сам с каждым платежом.