Payroc для WooCommerce — оплата карткою на сторінці Payroc

Payroc Payments for WooCommerce приймає оплату карткою через сторінку оплати Payroc (Hosted Payment Page). Покупець обирає Payroc на касі, вводить картку на сторінці Payroc і повертається в магазин; замовлення оплачується лише тоді, коли підпис відповіді збігся, а сума дорівнює сумі замовлення. Підтримуються термінали у USD і CAD, класична й блокова каса, HPOS.

Що робить безкоштовна версія

Налаштування лежать в одному місці: WooCommerce → Payroc. Вкажіть режим (тестовий чи бойовий), ID терміналу, секрет терміналу і валюту терміналу; секрет і ключ API зберігаються зашифрованими. Модуль показує дві адреси для порталу Payroc Self-Care: Receipt Page URL, куди Payroc повертає покупця, і Validation URL, куди Payroc надсилає підтвердження у фоні, навіть якщо покупець закрив сторінку. Кнопка «Check connection» питає Payroc, чи знає він термінал і чи він активний. На касі запит підписується (SHA-512) і йде на сторінку оплати Payroc; для кожної спроби створюється новий номер замовлення в Payroc, кошик не очищається, доки замовлення не оплачене. Відповідь Payroc перевіряється: підпис, сума й посилання на замовлення. Схвалена оплата переводить замовлення в «Оплачено», відхилена — в «Не вдалося» з причиною, покупець повертається на сторінку оплати; повторні й запізнілі відповіді нічого не міняють, а розбіжність у сумі ставить замовлення на утримання. Повернення коштів, повні й часткові, робляться прямо із замовлення WooCommerce. Кнопка «Check payment status» у замовленні питає Payroc про платіж.

Що додає Pro

Посилання на оплату для будь-якого неоплаченого замовлення (наприклад, прийнятого по телефону): одноразове, із заданою сумою і строком у днях; Payroc надсилає його покупцю листом, а оплачене або скасоване замовлення вимикає посилання саме. Режим «лише авторизація»: сума утримується на картці, замовлення стоїть на утриманні, списання відбувається при статусі «Виконано» чи «В обробці» або кнопкою, скасування замовлення знімає утримання. Масові дії у списку замовлень (повернути повністю, списати утримане, перевірити статус, до 50 за раз). Щогодинна фонова перевірка замовлень, за якими Payroc не прислав відповіді (останні 3 дні). Вкладка «Payments report»: платежі терміналу за період, розбиті на розраховані й нерозраховані, звірені із замовленнями (збігається, сума інша, схвалено, але не оплачено, замовлення немає в магазині) і вивантаження в CSV. До трьох додаткових терміналів для інших валют, кожен зі своїм секретом.

Що варто знати заздалегідь

• Receipt Page URL і Validation URL задаються в порталі Payroc Self-Care для кожного терміналу окремо. Якщо їх не вписати, покупець не повернеться в магазин, а замовлення залишиться в очікуванні (кнопка «Check payment status» у Free і щогодинна перевірка в Pro його підхоплять).
• Один термінал має одну адресу повернення: термінал, який уже працює з іншим сайтом чи інтеграцією, надсилатиме відповіді туди.
• Картку покупець вводить на сторінці Payroc, тож дані картки в магазин не потрапляють. Збережені картки й токени WooCommerce у цій версії не підтримуються.
• Для повернень і перевірки статусу потрібен ключ API з Payroc Developer Portal (кнопка оплати без нього працює).
• Payroc не виконує попередню авторизацію для мерчантів із сурчарджем, dual pricing чи convenience fee. Якщо автоматичне списання не вдалося, у замовленні лишається нотатка, а саме замовлення вже змінило статус.

Як це працює, крок за кроком

1. У порталі Payroc Self-Care візьміть ID терміналу й секрет терміналу, у Developer Portal створіть ключ API.
2. У WooCommerce → Payroc введіть їх, оберіть валюту терміналу й натисніть «Check connection».
3. Скопіюйте з налаштувань Receipt Page URL і Validation URL у портал Payroc Self-Care (термінал → Settings) і ввімкніть Validation.
4. Увімкніть Payroc у WooCommerce → Налаштування → Оплата й зробіть тестове замовлення в тестовому режимі.

Під капотом

• Запит на сторінку оплати підписується SHA-512, відповідь перевіряється за підписом, сумою й номером замовлення, який видав магазин.
• Блокування від гонки: відповідь на сторінці повернення й фонове підтвердження обробляються по одному разу.
• Повернення йдуть з ключем ідемпотентності, помилки Payroc (RFC 7807) показуються словами.
• Секрет терміналу й ключ API зберігаються зашифрованими; сумісно з HPOS і блоковою касою; мова: English.

Як встановити

1. Плагіни → Додати новий → Завантажити плагін: оберіть zip і активуйте.
2. WooCommerce → Payroc: термінал, секрет, ключ API, «Check connection».
3. Додайте обидві адреси в портал Payroc Self-Care.
4. Увімкніть метод оплати Payroc.

Модуля ще немає на wordpress.org: безкоштовна версія і Pro — один архів з цієї сторінки. Без ключа він працює як безкоштовна версія.