Portmone для WooCommerce — оплата карткою, Apple Pay і Google Pay

Portmone для WooCommerce — платіжний плагін, який приймає оплату карткою, Apple Pay і Google Pay через Portmone.com. Покупець переходить на сторінку оплати Portmone, платить, а замовлення в магазині підтверджується само. Головна відмінність від звичайного «редірект і повірили на слово»: плагін не довіряє ні поверненню покупця, ні сповіщенню — перед тим як позначити замовлення оплаченим, він сам питає Portmone про статус і звіряє суму.

Що отримує адмін

• Payee ID, логін і пароль магазину з кабінету Portmone. Пароль і ключ підпису зберігаються в базі зашифрованими.
• «Перевірити підключення» — плагін робить запит статусу вашими даними, а якщо вказано ключ підпису, створює тестовий рахунок на 1 грн і одразу його закриває. Помилку в паролі чи ключі ви побачите в адмінці, а не від покупця.
• Нотатки в замовленні: номер замовлення в Portmone, номер рахунку, маска картки, результат кожної звірки.
• Час на оплату — скільки хвилин посилання лишається дійсним.
• Статус після оплати — «В обробці» чи одразу «Виконано».

Як це працює — крок за кроком

1. Покупець на чекауті обирає «Картка, Apple Pay, Google Pay (Portmone)» і підтверджує замовлення. Працює і в класичному, і в блоковому чекауті.
2. Плагін створює посилання на оплату в Portmone з унікальним номером спроби, сумою й валютою замовлення. Якщо Portmone видав вам ключ підпису, запит підписується HMAC-SHA256.
3. Покупець платить на сторінці Portmone — карткою, Apple Pay, Google Pay або іншими способами, які увімкнено для вашого магазину. Дані картки не проходять через ваш сайт.
4. Покупець повертається в магазин. Плагін ігнорує те, що прийшло в адресі чи POST, і запитує статус у Portmone логіном і паролем магазину.
5. Звірка суми. Якщо оплачено менше, ніж коштує замовлення, воно не стає оплаченим, а переходить «На утриманні» з нотаткою для менеджера.
6. Замовлення переходить у «В обробці» (або в обраний статус), списуються залишки, покупцю йде лист WooCommerce.
7. Якщо покупець закрив вкладку і не повернувся — спрацює сповіщення від Portmone на адресу з налаштувань, і плагін так само перевірить статус через API. Резервно статус тягнеться ще й на сторінці «Дякуємо».
8. Повторна спроба (карта відхилена, покупець натиснув «Оплатити» ще раз): плагін спершу перевіряє, чи не оплачено попереднє посилання, і закриває старий рахунок у Portmone, щоб одне замовлення не оплатили двічі.
9. З Pro у режимі преавторизації кошти лише блокуються на картці. Переводите замовлення у «Виконано» — кошти списуються; скасовуєте — блокування знімається. Платіжні системи тримають блокування до 7 днів.

Що під капотом

• Статус — лише з API Portmone. Повернення покупця, сповіщення і кнопка звірки ведуть в одну точку: запит result з логіном і паролем магазину. Підробити оплату, надіславши POST на сайт, не вийде.
• Звірка суми й належності: номер замовлення має бути виданий саме цьому замовленню, Payee ID — вашим, сума — не меншою за суму замовлення.
• Захист від подвійного підтвердження: повернення покупця і сповіщення часто приходять одночасно. Блокування на рівні бази й перечитування замовлення (з урахуванням кешу HPOS) гарантують одну нотатку «оплату отримано» й одне списання залишків.
• Пізні статуси не відкочують оплату: запізніле «відхилено» від старої спроби не зробить оплачене замовлення невдалим.
• Власний ідентифікатор шлюзу: плагін не конфліктує з офіційним модулем Portmone, якщо той теж встановлений.
• Пароль у логах маскується, а в базі зберігається зашифрованим.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції. Заблоковані до цього кошти все одно списуються при «Виконано», щоб гроші покупця не зависли.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть portmone-for-woocommerce-1.0.2.zip і активуйте.
2. WooCommerce → Налаштування → Платежі → Portmone.
3. Впишіть Payee ID, логін і пароль магазину (і ключ підпису, якщо Portmone його видав), збережіть.
4. Натисніть «Перевірити підключення».
5. Надішліть менеджеру Portmone адресу для сповіщень — вона показана внизу сторінки налаштувань.
6. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал.