Payment Status Sync для WooCommerce — сверка заказов «В ожидании оплаты» с платёжной системой: LiqPay, monobank, WayForPay, Portmone, Stripe, PayPal

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

Плагин сам спрашивает платёжную систему о заказах, ожидающих оплату, — через её официальное API статуса, тем же запросом, на который должно было ответить уведомление. Оплаченным заказ становится только тогда, когда платёжная система подтвердила оплату, а сумма и валюта совпадают с заказом. Недоплату, другую валюту, оплату другого заказа или оплату без списания плагин показывает и оставляет человеку: ничего не меняется наугад.

Работает с нашими модулями оплаты для WooCommerce — LiqPay, monobank, WayForPay и Portmone — и с официальными плагинами WooCommerce Stripe Payment Gateway и WooCommerce PayPal Payments. Нашим модулям отдельные ключи не нужны: статус читает и применяет сам модуль оплаты своими настройками.

Магазин на OpenCart? Для него есть отдельный модуль — Payment Status Sync для OpenCart (сборки для 4.x, 3.x и 2.3, LiqPay, monobank, WayForPay и Portmone).

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

Покупатель ничего нового не видит: чекаут, страница оплаты и страница благодарности остаются такими, как их делает ваш модуль оплаты. Разница в том, что его оплаченный заказ не висит «В ожидании оплаты»: как только платёжная система подтверждает оплату, заказ переходит в «Обработку», WooCommerce отправляет обычное письмо «Ваш заказ обрабатывается» и списывает запас — ровно один раз. Если в магазине включено «Удерживать запас», Pro не даст WooCommerce отменить заказ, за который деньги уже пришли.

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

• WooCommerce → Payment Status Sync с вкладками «Зависшие заказы», «Журнал проверок», «Настройки» и «Лицензия».
• Список заказов, ожидающих оплату: сколько ждёт, сумма, способ оплаты, статус и результат последней проверки с пояснением — например, «в заказе нет попытки оплаты — покупатель не дошёл до страницы оплаты». Новые первыми, с пагинацией и точным счётчиком даже на тысячах заказов.
• «Проверить» возле каждого заказа и «Проверить выбранные в платёжной системе» для нескольких сразу; сверху — когда была последняя проверка, сколько заказов ждёт и какие платёжные системы подключены.

На странице заказа — блок «Статус оплаты в платёжной системе»: что ответила платёжная система, когда, и кнопка «Проверить в платёжной системе». Когда оплата подтверждена, в заметках заказа появляется запись модуля оплаты (здесь — «Portmone: оплату получено») и обычные записи WooCommerce о письме и запасе.

В списке заказов WooCommerce есть групповое действие «Проверить оплату в платёжной системе» (до 25 заказов за раз) с итогом: сколько проверено, сколько отмечено оплаченными, сколько пропущено. Отдельное уведомление появляется, когда за последние 24 часа оплаты не совпали с заказами по сумме, валюте или номеру заказа.

Журнал проверок хранит каждую проверку: время, заказ, платёжную систему с её собственным статусом (error, 3ds_verify, APPROVED…), кто проверял — вручную, массово, автоматически или перед автоотменой, — статус заказа и пояснение. Free хранит 14 дней, Pro — 90 дней с экспортом в CSV.

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

1. Что считать «зависшим». По умолчанию — заказы «В ожидании оплаты» старше 15 минут (более молодой ещё может быть на странице оплаты) и моложе 72 часов. По желанию — ещё «Неудачный», «На удержании» и «Отменён».
2. Кто отвечает. Для каждого заказа плагин берёт способ оплаты и соответствующий коннектор: наш модуль LiqPay, monobank, WayForPay или Portmone — тогда статус читает клиент самого модуля с его ключами; Stripe — по PaymentIntent или Checkout Session, которые записал официальный плагин; PayPal — по заказу PayPal Orders v2. Для других способов оплаты проверки нет, и в списке это видно.
3. Вопрос платёжной системе. LiqPay — status, monobank — invoice/status, WayForPay — CHECK_STATUS, Portmone — запрос результата платежа, Stripe — /v1/payment_intents и /v1/checkout/sessions, PayPal — /v2/checkout/orders.
4. Решение. Оплачено, сумма и валюта совпадают — заказ становится оплаченным, с заметкой, откуда подтверждение. Средства заблокированы (hold, requires_capture) или суммы не совпадают — «На удержании» для ручной проверки. Ещё обрабатывается — заказ ждёт дальше. Покупатель не дошёл до оплаты — ничего не меняется.
5. Отклонённые оплаты. По умолчанию плагин только сообщает о них. С Pro-опцией «Отмечать неудачными» отклонённая, отменённая или просроченная оплата переводит заказ в «Неудачный» (или «Отменён», как это делает модуль оплаты).
6. Сводка. Раз в час плагин собирает заказы, которые ждут дольше заданного времени (по умолчанию 60 минут), и отправляет одно письмо — каждый заказ попадает туда один раз. Во Free эта проверка не обращается к платёжным системам, она только напоминает.

Pro. Заказы в очереди сверяются с платёжной системой сами — каждые 5, 10, 15, 30 или 60 минут, не больше заданного количества за раз (по умолчанию 20). Каждый заказ проверяется с растущей паузой — 10, 20, 40 минут и дальше до 6 часов, — так что брошенные корзины не съедают лимиты запросов. Перед тем как WooCommerce отменит неоплаченный заказ после времени «Удерживать запас», Pro спрашивает платёжную систему: оплаченный заказ становится оплаченным, а не отменённым; если платёжная система не отвечает, заказ удерживается до 24 часов. Отдельно Pro считает долю неоплаченных заказов каждого онлайн-способа оплаты за последние 6 часов и сравнивает с его же уровнем за предыдущие 14 дней — резкий скачок обычно означает, что сломалась страница оплаты или уведомления.

Для Stripe достаточно ограниченного ключа (rk_live_…) с правом Read на PaymentIntents и Checkout Sessions; тестовый ключ — для заказов в тестовом режиме. Для PayPal — Client ID и Secret REST-приложения вашего бизнес-аккаунта (developer.paypal.com → Apps & Credentials), отдельно для live и sandbox. Ключи хранятся зашифрованными и обратно в форму не выводятся.

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

• Модули CatCode: статус читает собственный клиент модуля оплаты (его ключи, его подпись), а применяет сам модуль — под своей блокировкой и со своей проверкой суммы и валюты. Поэтому позднее уведомление платёжной системы не даёт второй оплаты.
• Stripe: PaymentIntent или Checkout Session из метаданных официального плагина; сумма сверяется в минимальных единицах валюты, в том числе для валют без копеек; metadata.order_id должен совпадать с заказом. Несколько ключей (live, test) перебираются, пока платёжная система не узнает оплату.
• PayPal: OAuth-токен кэшируется; оплаченным считается только списание (capture) со статусом COMPLETED и суммой заказа. APPROVED без списания — только заметка: плагин никогда не списывает деньги сам.
• Блокировки на проверку и на каждый заказ; перед отметкой «оплачено» заказ перечитывается из базы (с очисткой кэша HPOS).
• Масштаб: на тесте с 3 000 неоплаченных заказов список открывался за 0,3–0,4 с, Pro-прогон на 20 проверок — за 0,4 с; прогон ограничен 40 секундами, чтобы не нагружать медленный сервер.
• Ключи Stripe, PayPal и токен Telegram — AES-256 с HMAC, ключ производный от солей WordPress.
• Удаление плагина убирает настройки, журнал, отметки в заказах и задания крона.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите catcode-payment-status-sync-for-woocommerce-1.0.0.zip и активируйте (WooCommerce должен быть активен).
2. Откройте WooCommerce → Payment Status Sync — список заказов, ожидающих оплату, появится сразу.
3. Настройки: какие статусы отслеживать, с какого возраста начинать и когда прекращать, кому отправлять сводку.
4. Для Stripe — вставьте ограниченный ключ с правом Read; для PayPal — Client ID и Secret REST-приложения. Модулям CatCode ничего не нужно.
5. Нажмите «Проверить» возле заказа или «Запустить проверку сейчас».
6. Для Pro: вставьте лицензионный ключ из письма после оплаты или нажмите «Попробовать Pro бесплатно 7 дней» во вкладке «Лицензия».