NETOPIA Payments для WooCommerce — оплата карткою в Румунії, Oney і PayPo

NETOPIA Payments для WooCommerce — платіжний плагін для румунського ринку: покупець платить карткою на сторінці NETOPIA, а замовлення в магазині підтверджується само. Працює на NETOPIA API v2 — без файлів сертифікатів, достатньо підпису POS і API-ключа. Головна відмінність від звичайного «редірект і повірили на слово»: плагін не вірить ні поверненню покупця, ні сповіщенню — перед тим як позначити замовлення оплаченим, він перевіряє підпис сповіщення й сам питає NETOPIA про статус.

Як це виглядає для покупця

Далі покупець потрапляє на сторінку NETOPIA, платить Visa або Mastercard і повертається в магазин. Дані картки через ваш сайт не проходять. Якщо покупець закрив вкладку й не повернувся, замовлення все одно стане оплаченим — за сповіщенням від NETOPIA.

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

• Підпис POS і API-ключ — усе, що треба для старту. Сертифікати й ключові файли старого API не потрібні.
• Sandbox і live поруч. Два ключі зберігаються одночасно, перемикач один. Замовлення пам’ятає, у якому середовищі його оплатили, тому після переходу на бойові ключі старі тестові замовлення не «ламаються».
• «Перевірити підключення» — плагін робить запит до NETOPIA вашим ключем і каже, чи ключ прийнято, чи це 401, чи сервер просто не відповідає. Помилку в ключі ви побачите в адмінці, а не від покупця.
• Нотатки в замовленні: спосіб оплати, ID транзакції NETOPIA, маска картки, код авторизації, чим підтверджено оплату — сповіщенням чи запитом статусу.
• Адреса для сповіщень (IPN) показана в налаштуваннях, але передається в NETOPIA з кожним платежем — у кабінеті нічого налаштовувати не треба.
• Мова сторінки оплати: румунська, англійська або «як у магазині». Статус замовлення після оплати — на ваш вибір.
• Логування в журнал WooCommerce: запити й відповіді з маскованими контактами покупця, API-ключ у лог не потрапляє ніколи.

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

1. Покупець на чекауті обирає «Оплата карткою (NETOPIA Payments)», а з Pro — ще й спосіб: картка, Oney або PayPo. Працює і в класичному, і в блоковому чекауті.
2. Плагін створює платіж у NETOPIA (payment/card/start, для оплати частинами — payment/bnpl/start) з унікальним номером спроби, сумою й валютою замовлення. API-ключ іде в заголовку, у тілі — ваш підпис POS.
3. Покупець платить на сторінці NETOPIA. Oney відкривається POST-формою, PayPo — звичайним переходом; обидва партнери мають бути активовані для вашого POS.
4. Сповіщення (IPN) приходить на адресу магазину з підписом. Плагін перевіряє Verification-token: підпис має бути від NETOPIA, виданий саме на ваш підпис POS і точно на це тіло повідомлення. Підробити оплату, надіславши POST на сайт, не вийде.
5. Непідписане чи змінене сповіщення не застосовується, але й не ігнорується мовчки: плагін сам питає NETOPIA про статус. Не підтвердили — магазин відповідає «повторіть».
6. Повернення покупця — теж не доказ оплати. Плагін звіряє статус запитом operation/status за підписом POS, ID транзакції та номером замовлення.
7. Звірка суми й валюти. Якщо оплачено менше, ніж коштує замовлення, воно не стає оплаченим, а переходить «На утриманні» з нотаткою для менеджера. Валюта, що не збігається, ігнорується.
8. Замовлення переходить у «В обробці» (або в обраний статус), списуються залишки, покупцю йде лист WooCommerce.
9. Повторна спроба (карта відхилена, покупець натиснув «Оплатити» ще раз): плагін спершу перевіряє, чи не оплачено попередню спробу, і лише потім створює нову — щоб одне замовлення не оплатили двічі.
10. З Pro можна повернути гроші з картки замовлення — повністю або частинами, у межах оплаченої суми.

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

• Підпис сповіщення перевіряється по-справжньому. Verification-token — це JWT з підписом RSA: плагін вимагає алгоритм RS256/384/512, видавця NETOPIA, ваш підпис POS у полі отримувача й sha512 точного тіла повідомлення. Токени з alg: none чи підписані «симетрично» вашим же публічним ключем відкидаються.
• Статус — лише з API NETOPIA. Повернення покупця, сторінка «Дякуємо», непідписане сповіщення і кнопка «Звірити» ведуть в одну точку: запит operation/status.
• Захист від подвійного підтвердження: сповіщення й повернення покупця часто приходять одночасно. Блокування на рівні бази й перечитування замовлення (з урахуванням кешу HPOS) гарантують одну нотатку «оплату отримано» й одне списання залишків.
• Пізні статуси не відкочують оплату: запізніле «відхилено» від старої спроби не зробить оплачене замовлення невдалим.
• Підміна способу оплати не проходить: якщо на чекауті підмінити вибір на Oney для суми поза лімітами, сервер відмовить.
• Власний ідентифікатор шлюзу (cc_netopia) і власні налаштування: плагін не конфліктує з офіційним модулем NETOPIA, якщо той теж встановлений. Показувати на чекауті варто лише один із них.
• API-ключі зберігаються в базі зашифрованими і не потрапляють у логи.
• Pro-гейт без «цегли»: коли тріал закінчився, зупиняються лише Pro-функції, а приймання оплати карткою працює далі.

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

1. Плагіни → Додати новий → Завантажити плагін: оберіть netopia-for-woocommerce-1.0.1.zip і активуйте.
2. WooCommerce → Налаштування → Платежі → NETOPIA Payments.
3. Впишіть підпис POS (admin.netopia-payments.com → Points of sale → ⋮ → Technical settings) і API-ключ sandbox (кабінет sandbox → Profile → Security), збережіть.
4. Натисніть «Перевірити підключення» і проведіть тестове замовлення картками NETOPIA sandbox.
5. Попросіть NETOPIA перевірити інтеграцію. Після активації POS впишіть бойовий ключ і вимкніть тестовий режим.
6. Для Pro: вставте ліцензійний ключ з листа після оплати або запустіть 7-денний тріал.