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