Przelewy24 & BLIK Payments для WooCommerce — оплата переводом, картой и BLIK в Польше

Przelewy24 & BLIK Payments для WooCommerce — платёжный плагин для польского рынка. Покупатель платит банковским переводом, картой или BLIK через Przelewy24, а заказ в магазине подтверждается сам. Плагин работает на Przelewy24 REST API v1 и не верит на слово ни возврату покупателя, ни уведомлению: оплата засчитывается только после проверки подписи и запроса transaction/verify, как того требует Przelewy24.

Что нужно от вас. Аккаунт продавца в Przelewy24 — merchant ID, ключ CRC и API-ключ выдаёт Przelewy24 после регистрации магазина. BLIK-код прямо в чекауте (Pro) работает, только если Przelewy24 включил для вашего аккаунта эту услугу (BLIK level 0); иначе поле кода скрывается само, а BLIK идёт через страницу Przelewy24.

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

Без Pro покупатель после «Оформить заказ» попадает на страницу Przelewy24, выбирает банк, карту или BLIK и возвращается в магазин. Данные карты и банка через ваш сайт не проходят. Если покупатель закрыл вкладку и не вернулся, заказ всё равно станет оплаченным — по уведомлению от Przelewy24.

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

• Merchant ID, POS ID, ключ CRC и API-ключ — всё, что нужно для старта. Где их взять в панели Przelewy24, подсказано прямо в настройках плагина.
• Sandbox и live рядом. Оба набора ключей хранятся одновременно, переключатель один. Заказ помнит, в какой среде его оплатили.
• «Проверить подключение» — плагин делает запрос к Przelewy24 вашими ключами и говорит, приняты ли они. Ошибку в ключе вы увидите в админке, а не от покупателя.
• Адрес для уведомлений передаётся в Przelewy24 с каждым платежом — в панели Przelewy24 ничего настраивать не нужно.
• Язык страницы Przelewy24, время на оплату, статус заказа после оплаты — на ваш выбор.
• Заметки в заказе: способ оплаты, номер транзакции Przelewy24, сумма, чем подтверждена оплата.
• Журнал отладки в журнале WooCommerce: контакты покупателя замаскированы, ключи не пишутся никогда.

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

1. Покупатель в чекауте выбирает Przelewy24 или BLIK. С Pro — ещё и конкретный банк из списка методов вашего аккаунта или вводит BLIK-код. Работает и в классическом, и в блочном чекауте.
2. Плагин регистрирует транзакцию в Przelewy24 (transaction/register) с уникальным номером сессии, суммой и валютой заказа и подписью SHA-384 на ключе CRC.
3. Покупатель платит на странице Przelewy24. Для BLIK-кода в чекауте (Pro) плагин передаёт код в Przelewy24 (chargeByCode), а покупатель подтверждает оплату в банковском приложении.
4. Уведомление приходит на адрес магазина. Плагин проверяет подпись SHA-384, merchant ID, POS ID, сумму и валюту. Подделать оплату, отправив POST на сайт, не получится.
5. Подтверждение. Плагин вызывает transaction/verify — без этого Przelewy24 не зачисляет деньги продавцу. Только после успешного verify заказ становится оплаченным.
6. Возврат покупателя — не доказательство оплаты. Плагин сам спрашивает Przelewy24 о статусе (transaction/by/sessionId). Страница заказа ждёт подтверждения и обновляется сама.
7. Сверка суммы. Если оплачено меньше, чем стоит заказ, он не становится оплаченным, а переходит «На удержании» с заметкой.
8. Заказ переходит в «В обработке» (или в выбранный статус), списываются остатки, покупателю уходит письмо WooCommerce.
9. Повторная попытка (покупатель отменил и нажал «Оплатить снова»): плагин сначала проверяет предыдущие сессии и только потом создаёт новую.
10. С Pro можно вернуть деньги из карточки заказа (transaction/refund) — полностью или частями; итог возврата от Przelewy24 записывается в заметки.

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

• Подпись проверяется по-настоящему. SHA-384 от JSON с полями уведомления и вашим ключом CRC, плюс совпадение merchant ID, POS ID, суммы и валюты с сессией заказа. Неподписанное или чужое уведомление не применяется — только становится поводом самим запросить статус у Przelewy24.
• transaction/verify обязателен. Заказ не становится оплаченным, пока Przelewy24 не подтвердил verify.
• Защита от двойного подтверждения: уведомление и возврат покупателя часто приходят одновременно. Блокировка на уровне базы и перечитывание заказа (с учётом кеша HPOS) дают одну заметку «оплата получена» и одно списание остатков.
• Вторая оплата уже оплаченного заказа не подтверждается автоматически — менеджер видит заметку и решает в панели Przelewy24.
• Подмена метода оплаты не проходит: если в чекауте подставить метод, которого нет среди активных на аккаунте, сервер откажет.
• Собственные идентификаторы шлюзов (cc_przelewy24, cc_przelewy24_blik) и собственные настройки: плагин не конфликтует с официальным модулем Przelewy24.
• Ключ CRC и API-ключ хранятся в базе зашифрованными (AES-256) и не попадают в логи.
• Pro-гейт без «кирпича»: когда триал закончился, останавливаются только Pro-функции, а приём оплаты работает дальше.

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

1. Плагины → Добавить новый → Загрузить плагин: выберите przelewy24-blik-woocommerce-1.0.0.zip и активируйте.
2. WooCommerce → Настройки → Платежи → Przelewy24.
3. Впишите merchant ID, POS ID (если отличается), ключ CRC и API-ключ sandbox-аккаунта, сохраните и нажмите «Проверить подключение».
4. Проведите тестовый заказ в sandbox.
5. Впишите боевые ключи и выключите тестовый режим.
6. При необходимости включите отдельный метод «BLIK (Przelewy24)» в списке платежей.
7. Для Pro: вставьте лицензионный ключ из письма после оплаты или запустите 7-дневный триал.