Payment Status Sync для OpenCart — сверка «ожидает оплату» с банком: LiqPay, monobank, WayForPay, Portmone

Payment Status Sync для OpenCart — модуль для магазинов, которые принимают оплату картой. Бывает так: покупатель оплатил, банк деньги принял, а заказ в админке до сих пор «ожидает оплату». Статус «оплачено» ставит уведомление, которое банк отправляет на сайт, и если оно не дошло — сайт был недоступен, изменился адрес уведомлений, запрос отрезал файрвол, — заказ так и висит. Его не отправляют, покупатель пишет в поддержку, а менеджер идёт в кабинет банка сверять платежи вручную.

Модуль сам спрашивает банк о каждом заказе, который ждёт оплату, — через официальные API статуса платежа LiqPay, monobank (Mono Acquiring), WayForPay и Portmone — и показывает заказы, которые на самом деле оплачены, с кнопкой «Применить оплату». Проверка — только по статусу, который возвращает банк: модуль ничего не угадывает по корзине, письмам или времени. Недоплаты, оплаты в другой валюте, холды и возвраты он показывает, но статус заказа не меняет.

Работает с нашими платёжными модулями для OpenCart: LiqPay, Mono Acquiring (monobank), WayForPay и Portmone. Ключи берёт из их настроек — вводить их повторно не нужно.

Магазин на WooCommerce? Для него есть отдельный плагин — Payment Status Sync для WooCommerce: LiqPay, monobank, WayForPay и Portmone (наши модули оплаты), а также Stripe и PayPal.

Как это выглядит для покупателя

На витрине и в оформлении заказа ничего не меняется: модуль не добавляет скриптов и не делает запросов со страниц магазина. Покупатель замечает только следствие: оплаченный заказ не застревает в «ожидает оплату», его отправляют, а не просят «прислать квитанцию». Если в настройках включено «Уведомлять покупателя», он получит обычное письмо OpenCart о смене статуса.

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

Пункт меню Продажи → «Сверка оплат» со счётчиком заказов, требующих внимания, и страницы «Монитор», «Способы оплаты», «Журнал», «Настройки».

• Плитки: сколько заказов требуют внимания, сколько ждут оплату, сколько исправлено за 7 дней и когда была последняя проверка.
• Карточки платёжных модулей: для LiqPay, monobank, WayForPay и Portmone — установлен ли модуль, сохранены ли ключи, тестовый режим, двухэтапная оплата.
• «Требует внимания»: оплачено в банке, но заказ ждёт; недоплата; деньги заблокированы (холд); ошибка API. «Ожидают» — ещё не оплачены, «Закрытые» — исправленные и те, что получили новый статус иначе.
• Кнопки: «Проверить все сейчас», «Проверить» для одного заказа, «Применить оплату» (банк запрашивается ещё раз) и «Убрать» из списка — в самом заказе при этом ничего не меняется.

Строка на странице заказа

В заказах, оплаченных одним из четырёх модулей, вверху — что в последний раз сказал банк и когда, и кнопки «Спросить банк сейчас» и «Применить оплату». Строка выключается в настройках.

Способы оплаты

• Доля оплаченных заказов для каждого способа оплаты магазина — не только четырёх банков, но и, например, наложенного платежа — за последние 24 часа против 14 дней до того.
• «Падение» — когда доля упала на 25 пунктов и больше и в окне не меньше 5 заказов. Резкое падение обычно означает, что банк перестал подтверждать оплаты (просроченные ключи, изменённый адрес уведомлений, сломанный чекаут), а не что покупатели передумали. Все пороги меняются в настройках.

Pro: автоматизация и уведомления

• Автоматическое применение: когда банк подтверждает полную оплату в валюте заказа, заказ получает статус «оплачено» без клика — в том числе потерянный заказ без статуса, которого не видно в списке заказов.
• Уведомления на до 5 e-mail через почтовые настройки магазина и в Telegram (токен бота и ID чата): одно сообщение за прогон — что исправлено, что требует человека (недоплаты, холды), ошибки API (не чаще раза в 6 часов на банк) и падение способа оплаты (раз в 12 часов).
• Статус «неудачная оплата» — по желанию: когда проверки закончились, а последнее слово банка «отклонено» или «просрочено», заказ переходит из статуса ожидания платёжного модуля в его статус неудачной оплаты. По умолчанию выключено.
• CSV журнала — UTF-8 с BOM, открывается в Excel.

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

1. Модуль берёт заказы, оплаченные одним из четырёх платёжных модулей, у которых журнал оплаты ещё «не оплачено»: без статуса (потерянные), в статусе ожидания платёжного модуля, в статусе нового заказа или в статусах, которые вы выбрали сами. Оплаченные и выполненные заказы не проверяются никогда.
2. Первый запрос — через 15 минут после последнего изменения статуса, дальше всё реже, до раза в 12 часов; через 72 часа модуль перестаёт спрашивать.
3. Запрос статуса идёт строго по документации банка: LiqPay — action=status, monobank — статус счёта с токеном мерчанта, WayForPay — CHECK_STATUS с проверкой подписи ответа, Portmone — method=result. Ключи и секреты берутся из настроек платёжного модуля и расшифровываются так же, как это делает он сам.
4. Если банк подтверждает полную оплату в валюте заказа, модуль под блокировкой ещё раз перечитывает заказ и журнал оплаты, записывает оплату в журнал платёжного модуля и ставит статус «оплачено» через штатную историю заказа OpenCart — так же, как это делает уведомление банка: остатки, купоны и письма работают как обычно.
5. Недоплата, другая валюта, холд, возврат — только запись в мониторе и журнале (и уведомление в Pro). Банк не ответил или ограничил частоту запросов — заказ перепрашивается позже, ничего не меняя.

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

• Без правок ядра. Без OCMOD-патчей; пункт меню и строка на странице заказа добавляются событиями OpenCart. Одна библиотека классов одинакова в трёх сборках, код совместим с PHP 7.0.
• Собственные таблицы oc_cc_paysync_check (состояние проверки каждого заказа) и oc_cc_paysync_log (журнал событий). Таблицы ядра не меняются; в журнале платёжного модуля обновляется только строка оплаченного заказа — условным запросом, так что параллельное уведомление банка не перезаписывается.
• Банки по кругу. Прогон делит лимит запросов между банками и заканчивается за 35 с, даже когда банк отвечает медленно. HTTP 429 от банка ставит этот банк на паузу до конца прогона, не засчитывая попытку.
• Адрес проверки index.php?route=extension/cc_paysync/cron.cron&key=… (в 3.x и 2.3 — extension/module/cc_paysync_cron/cron): без ключа — «403». Кнопки админки вызывают тот же адрес.
• Лицензия живёт в отдельной группе настроек: «Сохранить» её не трогает.
• Деинсталляция снимает события и (OpenCart 4) задание планировщика, журнал и состояние проверок оставляет — повторная установка их видит. Для полного удаления удалите таблицы oc_cc_paysync_* вручную.

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

1. OpenCart 4: Расширения → Установщик → загрузите cc_paysync.ocmod.zip (имя архива не меняйте) и нажмите «Установить». OpenCart 3: Расширения → Установщик → cc_paysync-oc3.ocmod.zip. OpenCart 2.3: залейте содержимое папки upload/ из cc_paysync-oc2.ocmod.zip в корень магазина (FTP или файловый менеджер хостинга) — Установщик 2.3 без настроенного FTP файлы не копирует.
2. Расширения → Расширения → Модули → CatCode Payment Status Sync → «Установить».
3. Продажи → «Сверка оплат». На карточках платёжных модулей должно быть «проверяется»; нажмите «Проверить все сейчас».
4. Во вкладке «Расписание» скопируйте строку для cron хостинга (каждые 5–10 минут). В OpenCart 4 проверка и без неё запускается каждый час.
5. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro 7 дней» во вкладке «Лицензия».