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