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.