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 — один архив с этой страницы. Без ключа он работает как бесплатная версия.