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