EasyPay для WooCommerce — оплата картой, Apple Pay и Google Pay

EasyPay для WooCommerce — платёжный плагин, который принимает оплату через EasyPay: картой Visa/Mastercard, Apple Pay и Google Pay. Покупатель переходит на защищённую страницу EasyPay, платит, а заказ в магазине подтверждается сам. EasyPay присылает подписанное уведомление, плагин проверяет подпись, отдельно запрашивает у EasyPay статус платежа и сверяет сумму. Только после этого заказ становится оплаченным. Сверять оплаты в кабинете EasyPay вручную не нужно.

Как это выглядит для покупателя

Покупатель, который не завершил оплату, возвращается на страницу оплаты заказа и может попробовать ещё раз. Новый заказ создавать не нужно: плагин сам выдаст EasyPay новый номер попытки. Если включить напоминание, EasyPay через 15–20 минут отправит покупателю SMS или Viber о неоплаченном заказе.

Что получает админ

• «Проверить ключи» отправляет подписанный запрос статуса. Ошибку плагин называет конкретно: EasyPay не знает PartnerKey, не знает ServiceKey или отклоняет подпись, то есть неверный SecretKey. О проблеме вы узнаете в админке, а не от покупателя.
• Заметки в заказе: номер заказа в EasyPay, транзакция, отказ с причиной от банка, возврат, блокировка и списание.
• Статус после оплаты: «Обработка» или сразу «Выполнен».
• Pro-журнал платежей: все платежи EasyPay в одном списке. Там сумма, возвраты, статус в EasyPay и статус заказа, номер транзакции, а статус можно проверить одним кликом.

Как это работает — шаг за шагом

1. Покупатель на чекауте выбирает EasyPay и подтверждает заказ.
2. Плагин создаёт заказ в EasyPay: номер, сумму, описание, адрес для уведомлений и страницы возврата. Каждый запрос подписывается вашим SecretKey.
3. Покупатель платит на странице EasyPay картой, Apple Pay или Google Pay.
4. EasyPay отправляет уведомление на ваш сайт. Плагин проверяет подпись. Неподписанный или поддельный запрос получает отказ, и заказ остаётся как был.
5. Плагин сам запрашивает у EasyPay статус этого платежа. Тело уведомления используется только для того, чтобы найти заказ, поэтому «оплатить» его фальшивым запросом не получится.
6. Сумма сверяется с суммой заказа. Если оплачено меньше, заказ получает статус «На удержании» с заметкой для проверки, а не «Обработка».
7. Если уведомление задержалось, статус проверяется ещё и тогда, когда покупатель возвращается в магазин. Оплаченный заказ не останется «в ожидании».
8. С Pro в режиме hold средства только блокируются на карте. Списываются они, когда вы переводите заказ в «Выполнен», а отмена заказа их разблокирует. Так удобно, если товар нужно сначала собрать или проверить наличие.

Что под капотом

• Подпись в обе стороны: base64(SHA-256) от SecretKey и тела запроса. Уведомления с неверной подписью плагин отклоняет.
• Статус берётся из EasyPay (orderState), а не из уведомления. Опционально уведомления можно принимать только с IP-адресов EasyPay.
• Защита от двойного списания: уведомление и возврат покупателя приходят одновременно, но обрабатываются по очереди под блокировкой. «Оплата получена» записывается один раз даже при нескольких параллельных уведомлениях. Покупатель, который нажал «Назад» после оплаты, не создаст второй заказ в EasyPay.
• Уникальные номера заказов для EasyPay: префикс магазина, а для повторной попытки суффикс -2, -3. Если номер уже занят, плагин сам берёт следующий.
• Возвраты без переплат (Pro): перед возвратом плагин спрашивает у EasyPay, сколько ещё можно вернуть. Возвраты, сделанные в кабинете EasyPay, тоже учитываются.
• SecretKey хранится зашифрованным, а повторное сохранение настроек его не портит, даже со спецсимволами.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции, а приём оплаты не ломается.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите easypay-for-woocommerce-1.0.2.zip и активируйте.
2. Откройте WooCommerce → Настройки → Платежи → EasyPay и включите способ оплаты.
3. Для проверки оставьте включённой «Песочницу» и нажмите «Проверить ключи».
4. Для реальных оплат выключите песочницу, впишите PartnerKey, ServiceKey и SecretKey от EasyPay, сохраните и ещё раз нажмите «Проверить ключи». Адрес для уведомлений плагин передаёт сам с каждым заказом, в кабинете EasyPay ничего настраивать не нужно.
5. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал.