iyzico Checkout для OpenCart — оплата картой в Турции с рассрочкой

iyzico Checkout для OpenCart — модуль оплаты для магазинов на OpenCart 4 и OpenCart 3, которые продают в Турции через iyzico. Покупатель платит картой на защищённой странице iyzico с 3D Secure и рассрочкой (taksit), а заказ становится оплаченным только после того, как ваш сервер сам запросил результат в iyzico и проверил подпись, сумму, валюту и номер корзины.

Зачем ещё один модуль iyzico. Официальный модуль iyzico для OpenCart развивается вместе с плагином для WooCommerce, у которого рейтинг 1,7 из 5 и жалобы на заказы без статуса и сломанные обновления. Мы сделали модуль, где оплата подтверждается сервером, вебхук спасает заказ, когда покупатель закрыл вкладку, а спорные платежи (антифрод, недоплата) не становятся «оплаченными» сами.

Что получает админ

• Пять статусов под ваш процесс: ожидает оплаты, оплачен, требует проверки (антифрод или расхождение суммы), отклонён, возвращён.
• «Проверить ключи» — один подписанный запрос к iyzico без создания платежа.
• Pro-возвраты из журнала: полный в день оплаты проходит как отмена, частичные — по позициям корзины с учётом остатка. Пустое поле суммы = вернуть весь остаток, отрицательные и нечисловые суммы отклоняются.
• Pro-рассрочка: выбираете, какие варианты платежей показывает страница оплаты iyzico.

Как это работает — шаг за шагом

1. Покупатель оформляет заказ и на шаге оплаты нажимает «Оплатить картой».
2. Модуль создаёт Checkout Form в iyzico с покупателем, адресами и корзиной. Позиции корзины всегда равны сумме заказа (доставка, скидки, налоги и округление уравновешиваются). Запрос подписывается IYZWSv2, ответ iyzico проверяется по подписи.
3. Покупатель платит на странице iyzico: 3D Secure, рассрочка, кошелёк iyzico.
4. iyzico возвращает покупателя на адрес с номером заказа и HMAC-подписью — подставить чужой заказ невозможно. Модуль сам запрашивает результат сохранённым токеном и проверяет подпись, корзину, валюту и сумму.
5. Сессия покупателя не теряется: OpenCart 4 ставит cookie сессии с SameSite=Strict, поэтому после оплаты модуль проводит покупателя через страницу своего же сайта — корзина очищается, страница успеха показывается корректно.
6. Если покупатель закрыл вкладку, iyzico шлёт вебхук с подписью X-IYZ-SIGNATURE-V3, и модуль подтверждает заказ тем же серверным запросом.
7. Повторные ответы безопасны: оплаченный заказ не откатится, а строка «оплата получена» в истории записывается один раз даже при одновременных колбэке и вебхуке.

Что под капотом

• Собственная таблица транзакций cc_iyzico_order: токен, conversationId, среда, вердикт iyzico, транзакции позиций для возвратов.
• Один центр решений: колбэк, вебхук и проверка из журнала применяют результат через один и тот же код, поэтому никогда не противоречат друг другу.
• Защита от повторной оплаты: кнопка «Назад» после оплаты не отправит оплаченный заказ в iyzico второй раз, а устаревший заказ в сессии не уйдёт в банк со старой суммой.
• Настройки не теряются при сохранении: лицензия и триал не сбрасываются кнопкой «Сохранить».
• T.C. Kimlik No и ключи не пишутся в лог, секретные ключи в базе зашифрованы.
• Языки: турецкий, украинский, английский — админка и витрина.

Как установить

1. OpenCart 4: Расширения → Установка расширений → загрузите cc_iyzico.ocmod.zip и нажмите «Установить». OpenCart 3: Модули → Установка модулей → cc_iyzico-oc3-1.0.1.ocmod.zip.
2. Расширения → Расширения → Оплата → iyzico Checkout (CatCode) → «Установить», затем «Редактировать».
3. Вставьте API-ключ и секретный ключ из кабинета iyzico, нажмите «Проверить ключи», включите модуль и сохраните.
4. Скопируйте URL вебхука из настроек в кабинет iyzico → Merchant Notifications.
5. Для Pro: «Попробовать Pro» → e-mail для триала или ключ после покупки.