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-дневный триал.