VibeFox PayU for WooCommerce — Помощь

Требования

WordPress: 5.8 или новее.

WooCommerce: 7.0 или новее, установлен и активен. Плагин не активируется без него; если отключить WooCommerce позже, плагин не выполняет никаких действий и показывает уведомление в панели управления.

PHP: 8.0 или новее.

Валюта магазина: одна из PLN, EUR, CZK, HUF, RON, BGN, GBP, USD, CHF, DKK, NOK, SEK, UAH. Валюта также должна быть включена для вашей точки продаж в PayU. Для других валют способ оплаты скрывается при оформлении заказа.

Доступ к сайту из интернета: PayU отправляет уведомления о платежах в ваш магазин, поэтому сайт должен быть доступен из интернета (не закрыт HTTP-аутентификацией или страницей техобслуживания). Без уведомлений заказы всё равно проверяются при возвращении покупателя из PayU.

Учётная запись PayU: вам понадобятся четыре ключа вашей точки продаж (POS): POS ID, Second key (MD5), client_id OAuth и client_secret OAuth. Они находятся в панели мерчанта PayU в разделе Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Ключи sandbox берутся из отдельной учётной записи sandbox PayU.

Лицензионный ключ VibeFox: приобретается на vibefox.net. Один ключ работает на одном домене.

Установка

1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-файл плагина и нажмите Install Now. Вы также можете загрузить папку wcp_payu_payment в /wp-content/plugins/ по FTP.

2. Нажмите Activate.

3. Откройте настройки: WooCommerce > Settings > Payments > PayU > Manage или нажмите Settings под названием плагина на странице «Плагины».

4. Введите лицензионный ключ VibeFox в блок лицензии вверху страницы и нажмите Activate.

5. Введите четыре ключа Sandbox и четыре ключа Live (см. раздел «Настройка»). Настраивать URL уведомлений в PayU не требуется.

6. Включите Enable/Disable. Оставьте Test Mode включённым, пока не проведёте тестовый платёж, затем снимите отметку, чтобы принимать реальные платежи с ключами Live.

Настройка

Все параметры собраны на одной странице: WooCommerce > Settings > Payments > PayU. Над полями страница предупреждает, пока включён тестовый режим, если отсутствует хотя бы один из четырёх ключей текущего режима или если PayU не принимает валюту магазина. В двух последних случаях PayU не отображается при оформлении заказа.

При сохранении пробелы и переносы строк удаляются из всех ключей, так как при копировании из панели PayU они часто добавляются случайно.

Общие

Enable/Disable: Enable PayU payment gateway включает или выключает способ оплаты. По умолчанию: выключено.

Title: название способа оплаты, отображаемое покупателю. По умолчанию: PayU.

Description: описание способа оплаты, отображаемое покупателю. По умолчанию: Pay securely via PayU.

Учётные данные API

Ключи находятся в панели мерчанта PayU: Online payments > My shops > your shop > Points of sale (POS) > your POS > Configuration keys. Ключи sandbox берутся из отдельной учётной записи sandbox PayU. Все четыре ключа режима должны быть заполнены.

Test Mode: Enable sandbox (test) mode. Использует песочницу PayU и указанные ниже ключи Sandbox. Реальные деньги не списываются. На классическом оформлении заказа и в блоке «Оформление заказа» покупатель видит Sandbox mode — no real money is charged. Отключите его, чтобы принимать настоящие платежи с ключами Live. По умолчанию: включено.

Live POS ID: идентификатор POS (merchantPosId) вашей рабочей точки продаж.

Live Second Key (MD5): используется для проверки подписи уведомлений PayU.

Live OAuth Client ID: client_id OAuth вашей точки продаж.

Live OAuth Client Secret: client_secret OAuth вашей точки продаж.

Sandbox POS ID: идентификатор POS вашей тестовой точки продаж в sandbox PayU.

Sandbox Second Key (MD5): используется для проверки подписи уведомлений sandbox PayU.

Sandbox OAuth Client ID: client_id OAuth тестовой точки продаж.

Sandbox OAuth Client Secret: client_secret OAuth тестовой точки продаж.

Каждый платёж запоминает свою среду. Уведомления, проверки статуса и возвраты по платежу всегда используют ключи этой среды, поэтому старые платежи продолжают работать после переключения. Уведомление, подписанное ключом sandbox, никогда не принимается для рабочего платежа.

Уведомления о платежах

В этом разделе отображается URL уведомлений, который выглядит как https://your-site/wc-api/wc_pu_payment/. Плагин передаёт его в PayU при каждом платеже, поэтому в панели PayU ничего настраивать не нужно. Убедитесь, что он доступен из интернета (не блокируется брандмауэром, режимом техобслуживания или HTTP-аутентификацией).

Дополнительно

Receive payments automatically: Automatically receive payments waiting for confirmation. Имеет значение только в том случае, если в панели PayU для вашей POS отключён автоматический приём: платежи тогда ожидают подтверждения (WAITING_FOR_CONFIRMATION). При включении этой опции плагин принимает такие платежи сразу. При выключении — такие заказы переводятся в статус На удержании, и вы принимаете или отменяете платёж через действия заказа Receive PayU payment и Cancel PayU payment. По умолчанию: включено.

Logging: Enable logging записывает технические события (номера заказов, идентификаторы заказов PayU, статусы, ошибки; без ключей и персональных данных) в WooCommerce > Status > Logs, источник wcp_payu_payment. По умолчанию: выключено.

Delete data on uninstall: Delete the plugin settings and logs when the plugin is deleted. Заказы и их платёжные данные никогда не удаляются. Деактивация плагина сохраняет все данные. По умолчанию: выключено.

Оформление заказа

Покупатель выбирает способ оплаты (по умолчанию PayU) и оформляет заказ. Плагин создаёт заказ PayU на общую сумму заказа в валюте заказа, с описанием Order #, номером заказа и названием вашего магазина, а также с позициями заказа, доставкой и сборами для отображения на странице PayU. Язык страницы PayU соответствует языку магазина, если PayU его поддерживает, иначе английский. Покупатель перенаправляется на платёжную страницу PayU, выбирает способ и оплачивает.

Каждая попытка оплаты получает собственный заказ PayU. Когда покупатель оплачивает повторно (после неудачного или отменённого платежа либо со страницы Pay for order), предыдущий незавершённый платёж PayU по этому заказу отменяется в PayU, поэтому старую ссылку нельзя оплатить дважды.

Само по себе возвращение в магазин никогда не переводит заказ в оплаченный. Заказ отмечается оплаченным только после подтверждения PayU: по уведомлению, подписанному ключом Second Key среды платежа, либо по проверке статуса заказа PayU на сервере при возвращении покупателя (полезно при задержке уведомления). Заказ PayU должен быть создан именно для этого заказа, а сумма и валюта должны совпадать. Плагин обрабатывает следующие статусы PayU:

COMPLETED: платёж успешно совершён. Заказ отмечается оплаченным при совпадении суммы и валюты.

WAITING_FOR_CONFIRMATION: платёж авторизован и ожидает приёма. Он принимается автоматически или действиями заказа, см. Receive payments automatically.

CANCELED: платёж был отменён или отклонён. Неоплаченный заказ последней попытки получает статус Не удался. Более ранние попытки и оплаченные заказы не изменяются.

NEW, PENDING: платёж обрабатывается в PayU. Заказ не меняется.

На странице «Заказ получен», пока заказ всё ещё находится в статусе Ожидание оплаты, покупатель видит сообщение We have not received the payment confirmation from PayU yet. If the payment was interrupted, you can try again: или после неудачного платежа — The payment was not completed. You can try again:, каждое с кнопкой Pay again. Для заказа на удержании выводится сообщение Your payment is being verified. We will send you an e-mail as soon as it is confirmed.

Если PayU не удаётся запустить платёж, покупатель видит Payment error. Please try again or choose another payment method. Техническая причина (код HTTP и статус PayU) записывается в журнал и в примечание к заказу PayU payment could not be started:. Если отсутствуют ключи текущего режима, выводится сообщение Payment gateway is not configured properly. Please contact the administrator.

Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с High-Performance Order Storage (HPOS) WooCommerce.

Покупатель выбирает способ оплаты на странице PayU, а не при оформлении заказа. В плагине нет формы карты в вашем магазине, сохранённых карт или оплаты в один клик, подписок и виджетов рассрочки или кредита PayU. Используется одна точка продаж на каждую среду (без разделения точек продаж по валютам).

Заказы и возвраты

Статусы заказа

Pending payment: покупатель был направлен в PayU и ещё не оплатил заказ. Примечание к заказу показывает идентификатор заказа PayU и среду (sandbox или live).

Processing: платёж подтверждён. Примечание к заказу показывает идентификатор заказа PayU, сумму и среду. Идентификатор транзакции — это оплаченный идентификатор заказа PayU. Заказы, содержащие только виртуальные загружаемые товары, переходят в статус Выполнен, как WooCommerce делает по умолчанию.

On hold: оплаченная сумма или валюта не совпали с заказом, совершён платёж по уже отменённому заказу, либо платёж ожидает вашего подтверждения (автоматический приём выключен или не сработал). Примечание к заказу сообщает причину и дальнейшие действия.

Failed: последний платёж PayU был отменён или отклонён. Покупатель может повторить попытку оплаты.

Каждое уведомление обрабатывается один раз под блокировкой заказа: повторные уведомления не добавляют примечаний, не уменьшают складские остатки повторно и не отправляют лишние письма. Если завершается ещё один платёж по уже оплаченному или возвращённому заказу, примечание просит вас вернуть средства в панели PayU. Платёж, ожидающий подтверждения по уже оплаченному или закрытому заказу, отменяется автоматически, чтобы средства не были списаны дважды.

Платежи, ожидающие подтверждения

Для неоплаченного заказа с платежом, ожидающим подтверждения, на экране заказа доступны два действия: Receive PayU payment (waiting for confirmation) и Cancel PayU payment (release the funds). Выберите одно из них и нажмите кнопку обновления. Действие фиксируется в примечаниях к заказу с вашим именем пользователя, и новый статус PayU применяется немедленно.

Возвраты

Откройте заказ, нажмите Refund, введите сумму и нажмите Refund via PayU (на кнопке отображается ваш Title). Поддерживаются полные и частичные возвраты. Запрос на возврат отправляется для фактически оплаченного заказа PayU с ключами среды платежа, поэтому эти ключи должны быть настроены. Причина возврата передаётся в качестве описания возврата. Если PayU отклоняет возврат, WooCommerce отображает ошибку PayU, и возврат не фиксируется.

Возвраты в PayU выполняются асинхронно. Плагин сразу добавляет примечание с идентификатором и статусом возврата PayU; окончательный статус приходит позже в уведомлении PayU и добавляется в примечание. Если PayU отменяет возврат, в примечании указывается, что средства не были возвращены покупателю.

Заказы, переведённые в статус На удержании из-за несовпадения суммы или валюты, сохраняют идентификатор заказа PayU в качестве идентификатора транзакции, поэтому платёж можно вернуть как из WooCommerce, так и в панели PayU.

Лицензионный ключ

Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится вверху страницы WooCommerce > Settings > Payments > PayU. Вставьте ключ в поле License key и нажмите Activate. В блоке показан статус, например дата окончания действия лицензии и ваш домен. Используйте Check now, чтобы проверить статус снова, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить его с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.

Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот домена. Освободите слот в своём аккаунте на vibefox.net.

Без активного ключа PayU не отображается покупателям при оформлении заказа. Если платёж всё же запущен, покупатель видит сообщение This payment method is not available. Please choose another one. Авторизованные менеджеры магазина продолжают видеть способ оплаты с пометкой (unlicensed — visible to admins only), что позволяет настроить и протестировать плагин до покупки ключа. Напоминание отображается на странице «Плагины» и на страницах WooCommerce. На существующие заказы это не влияет: начатые платежи продолжают подтверждаться, а возвраты работают.

По истечении срока действия лицензии плагин продолжает работать, однако обновления и поддержка требуют продления. Статус повторно проверяется автоматически в фоновом режиме.

Устранение неполадок

PayU не появляется при оформлении заказа: проверьте, что лицензия активна, опция Enable/Disable включена и все четыре ключа текущего режима заполнены: ключи Sandbox в режиме sandbox, ключи Live в рабочем режиме. Убедитесь, что валюта магазина (или валюта заказа на странице Pay for order) входит в число поддерживаемых. Страница настроек показывает предупреждение для каждой из этих проблем.

Платёж прошёл, но заказ остаётся в статусе Ожидание оплаты: PayU ещё не доставил уведомление, а проверка статуса на странице возврата не обнаружила завершённого платежа. Убедитесь, что указанный в настройках URL для уведомлений доступен из интернета. Включите Logging, чтобы увидеть входящие данные.

Уведомление отвечает Invalid signature: уведомление не было подписано ключом Second Key ни одной из сред. Проверьте Live Second Key (MD5) и Sandbox Second Key (MD5). Ответ Invalid signature for this payment означает, что уведомление подписано ключом среды, отличной от среды совершения платежа.

Уведомление отвечает Ignored: заказ PayU не относится ни к одному заказу этого магазина, оплаченному через PayU (например, относится к другому магазину на той же POS). PayU прекращает повторные попытки.

Платёж не создаётся: включите Logging и откройте WooCommerce > Status > Logs, источник wcp_payu_payment. В журнале фиксируются HTTP-код и статус PayU. Сообщение Could not authenticate with PayU (check the OAuth client ID / secret). указывает на неверные ключи OAuth для текущего режима.

Заказ находится в статусе На удержании: прочитайте примечание к заказу. Причина может заключаться в несовпадении суммы или валюты, платеже после отмены заказа либо платеже, ожидающем подтверждения. В последнем случае используйте действия заказа Receive PayU payment или Cancel PayU payment.

Ошибка возврата: This order has no completed PayU payment. Cannot process refund. означает, что по заказу нет оплаченного заказа PayU. Сообщение об отсутствии ключей Sandbox или Live означает, что платёж проводился в соответствующей среде, а её ключи не заданы. Заполните их и повторите попытку.

Другие валюты: разработчики могут изменить список валют с помощью фильтра wc_pu_supported_currencies, а значок при оформлении заказа — с помощью фильтра wc_pu_icon.

Блок лицензии сообщает об ошибке: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите слот в аккаунте на vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать с последним известным статусом.

Удаление

Деактивация плагина сохраняет все настройки; сбрасываются только кэшированные токены доступа PayU. Чтобы удалить его, деактивируйте и удалите плагин на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда, вместе с кэшированными токенами. Настройки шлюза и журнал плагина удаляются только при включённой опции Delete data on uninstall. В противном случае они сохраняются для последующей повторной установки. Существующие заказы сохраняют свои примечания к платежам, идентификаторы заказов PayU и идентификаторы транзакций.

PayU — товарный знак соответствующего правообладателя. Этот плагин не связан с PayU и не одобрен ею.