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 днів» у вкладці «Ліцензія».