VibeFox Barion for WooCommerce — Помощь
Требования
WordPress: 6.0 или новее.
WooCommerce: 7.0 или новее, установлен и активен. Без WooCommerce плагин показывает уведомление в административной части, а способ оплаты не загружается.
PHP: 8.0 или новее.
Магазин Barion: нужны POSKey (секретный ключ) вашего магазина и e-mail адрес кошелька Barion, на который поступают платежи. Оба значения находятся в портале Barion: secure.barion.com для рабочей среды и secure.test.barion.com для тестовой, в разделе My stores и в вашем магазине. Тестовая и рабочая среды имеют разные учётные данные.
Валюта: валюта магазина должна быть HUF, EUR, USD или CZK. Для других валют способ оплаты скрывается при оформлении заказа.
Доступный магазин: Barion обращается к вашему магазину после каждого платежа, поэтому сайт должен быть доступен из интернета: без режима обслуживания, файрвола или базовой аутентификации перед /wc-api/.
Лицензионный ключ VibeFox: покупается на vibefox.net. Один ключ работает на одном домене.
Установка
1. В WordPress перейдите в Plugins > Add New > Upload Plugin, выберите ZIP-файл плагина и нажмите Install Now. Также можно загрузить папку wcp_barion_gateway в /wp-content/plugins/ по FTP.
2. Нажмите Activate.
3. Откройте настройки: WooCommerce > Settings > Payments > Barion > Manage или нажмите Settings под названием плагина на странице Plugins.
4. Введите ваш лицензионный ключ VibeFox в блоке лицензии вверху страницы и нажмите Activate.
5. Введите тестовый POSKey и тестовый e-mail кошелька, оставьте Test Mode включённым и включите Enable/Disable. Оформите тестовый заказ.
6. Когда всё работает, введите рабочие данные и снимите отметку Test Mode.
URL колбэка автоматически передаётся в Barion с каждым платежом. В портале Barion ничего настраивать не нужно.
Настройка
Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Barion. Если валюта магазина не поддерживается, страница сообщает об этом красным цветом в разделе Barion shop credentials и перечисляет поддерживаемые валюты; способ оплаты тогда скрывается при оформлении заказа.
Общие
Enable/Disable: Enable Barion Payment включает или выключает способ оплаты. По умолчанию: выключено.
Title: название способа оплаты, которое видят покупатели при оформлении заказа. По умолчанию: Barion.
Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely with Barion — card, Barion Wallet, Apple Pay or Google Pay.
Учётные данные магазина Barion
POSKey и e-mail кошелька берутся в портале Barion: secure.barion.com (рабочая среда) или secure.test.barion.com (тестовая среда), раздел My stores, ваш магазин. В этом разделе также показан URL колбэка, например https://your-site/wc-api/barion_payment_callback/. Он передаётся в Barion с каждым платежом и должен быть доступен из интернета.
Test Mode: Enable Barion test/sandbox mode. В тестовом режиме используются тестовые учётные данные ниже и тестовая среда Barion (sandbox, api.test.barion.com); реальные деньги не списываются. По умолчанию: включено. Снимите отметку, чтобы принимать реальные платежи.
Test POSKey: секретный ключ (POSKey) вашего магазина в тестовой системе Barion (secure.test.barion.com, My stores).
Test Payee Email: e-mail адрес вашего тестового кошелька Barion, на который поступают тестовые платежи.
Live POSKey: секретный ключ (POSKey) вашего магазина в рабочей системе Barion (secure.barion.com, My stores).
Live Payee Email: e-mail адрес вашего кошелька Barion, на который поступают платежи.
Заказы
Order Status After Payment: статус заказа, который устанавливается после успешной и проверенной оплаты.
Дополнительно
Logging: Enable debug logging. Журнал сохраняется в WooCommerce > Status > Logs, источник wcp_barion_gateway. Секретные ключи никогда не записываются. По умолчанию: выключено.
Delete Data on Uninstall: Remove the plugin settings when the plugin is deleted. Заказы и их платёжные данные Barion всегда сохраняются. По умолчанию: выключено.
Оформление заказа
Покупатель выбирает способ оплаты (по умолчанию Barion) и оформляет заказ. Плагин создаёт платёж Barion на сумму заказа в валюте заказа и отправляет покупателя на страницу оплаты Barion. В платеже перечислены товары заказа, доставка, сборы и налог, e-mail покупателя из платёжных данных передаётся как подсказка, а язык страницы следует языку магазина, если Barion его поддерживает.
После оплаты покупатель возвращается в ваш магазин. Barion также вызывает URL колбэка. Ни один из этих запросов сам по себе не отмечает заказ оплаченным: плагин запрашивает у Barion состояние платежа по вашему POSKey, и заказ отмечается оплаченным только после подтверждения Barion и совпадения суммы и валюты с заказом. Ссылка возврата содержит ключ заказа, и проверяются только платежи, начатые для этого заказа.
Если платёж прошёл или всё ещё обрабатывается в Barion, покупатель попадает на страницу «Заказ получен». Иначе покупатель возвращается к оформлению заказа и видит сообщение Payment was not completed. Please try again. Покупатель может повторить попытку; каждая попытка запоминается, поэтому поздний платёж по более ранней попытке всё равно завершит заказ.
Если платёж не удаётся начать, покупатель видит сообщение The Barion payment could not be started. Please try again or choose another payment method. Менеджеры магазина, вошедшие в систему, также видят техническую причину. Подробности попадают в журнал.
Способ оплаты работает в классическом оформлении заказа и в блоке «Оформление заказа». Он совместим с High-Performance Order Storage (HPOS) WooCommerce.
Плагин принимает только немедленные платежи. В нём нет платежей с резервированием или отложенным списанием, подписок WooCommerce и регулярных платежей, сохранённых карт, Barion Pixel и дополнительных данных 3-D Secure: 3-D Secure обрабатывает Barion на своей странице оплаты.
Заказы и возвраты
Статусы заказа
Pending payment: платёж Barion начат, и Barion ещё не подтвердил его. Примечание к заказу показывает PaymentId Barion, сумму и в тестовом режиме — (test mode).
Processing или Completed: Barion подтвердил платёж. Статус соответствует Order Status After Payment. Примечание к заказу показывает сумму, PaymentId и транзакцию. ID транзакции — это ID транзакции Barion.
On hold: Barion сообщил сумму или валюту, отличные от итога заказа, например потому что заказ был изменён после начала платежа. Проверьте платёж в портале Barion и вручную завершите заказ или сделайте возврат.
Cancelled: последняя попытка оплаты была отменена или истекла в Barion.
Failed: последняя попытка оплаты не удалась.
Оплаченный или возвращённый заказ никогда не меняется более поздним колбэком. Если для оплаченного заказа проходит другой успешный платёж, примечание просит проверить его в портале Barion и вернуть, если это дубликат.
Возвраты
Откройте заказ, нажмите Refund, введите сумму и нажмите Refund via Barion. Поддерживаются полные и частичные возвраты. Причина возврата передаётся в Barion как комментарий. Возвраты в HUF должны быть на целые суммы. Возврат отправляется в ту среду (тестовую или рабочую), в которой был оплачен заказ, поэтому POSKey этой среды должен быть задан. Если Barion не принимает или не подтверждает возврат, WooCommerce показывает ошибку, и возврат не записывается. Успешный возврат добавляется в примечания к заказу вместе с транзакцией и статусом Barion.
Лицензионный ключ
Плагин работает с лицензионным ключом VibeFox с vibefox.net. Блок лицензии находится вверху страницы WooCommerce > Settings > Payments > Barion. Вставьте ключ в поле License key и нажмите Activate. В блоке показан статус, например дата окончания действия лицензии и ваш домен. Используйте Check now, чтобы проверить статус снова, Change key, чтобы ввести другой ключ, и Remove key, чтобы удалить его с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш аккаунт на vibefox.net.
Один ключ работает на одном домене. Удаление ключа с сайта не освобождает слот домена. Освободите слот в вашем аккаунте на vibefox.net.
Без активного ключа Barion не показывается покупателям при оформлении заказа. Если оплата всё же начата, покупатель видит сообщение This payment method is not available. Please choose another one. Менеджеры магазина, вошедшие в систему, по-прежнему видят способ оплаты с пометкой (unlicensed — visible to admins only), чтобы вы могли настроить и протестировать плагин до покупки ключа. Напоминание появляется на странице Plugins и на страницах WooCommerce. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются, а возвраты работают.
Когда срок лицензии истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус снова проверяется автоматически в фоновом режиме.
Устранение неполадок
Barion не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено, в текущем режиме заполнены POSKey и e-mail получателя, а валюта магазина — HUF, EUR, USD или CZK.
Оплата прошла, но заказ остаётся в статусе Pending payment: заказ завершается, когда Barion вызывает URL колбэка или когда покупатель возвращается в магазин. Убедитесь, что сайт доступен из интернета (нет режима обслуживания, файрвола или базовой аутентификации перед /wc-api/). Проверьте, что POSKey той среды, в которой был оплачен заказ, указан верно, потому что плагин запрашивает состояние платежа у Barion с его помощью. Включите Logging, чтобы увидеть колбэк.
Колбэк отвечает Busy, retry: заказ в этот момент обрабатывал возврат покупателя. Barion вызовет колбэк повторно.
Колбэк отвечает API error: магазин не смог получить состояние платежа от Barion. Проверьте POSKey той среды, в которой был оплачен заказ.
Заказ в статусе On hold с примечанием о несовпадении: сумма или валюта, которые сообщает Barion, отличаются от итога заказа. Проверьте платёж в портале Barion и вручную завершите его или сделайте возврат.
Почему нельзя вернуть 10,50 HUF: Barion обрабатывает HUF без десятичных знаков. Введите целую сумму.
Возврат сообщает, что POSKey для режима этого заказа не настроен: заказ был оплачен в тестовом или рабочем режиме, а POSKey этого режима пуст. Введите его и повторите попытку.
Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите слот в вашем аккаунте на vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать по последнему известному статусу.
Удаление
Деактивация плагина сохраняет все данные. Чтобы удалить плагин, деактивируйте его и удалите на странице Plugins. Лицензионный ключ и статус лицензии этого плагина всегда удаляются. Настройки платёжного шлюза удаляются, только если была включена опция Delete Data on Uninstall. Иначе они сохраняются для повторной установки. Заказы и их платёжные данные Barion всегда сохраняются. Существующие заказы сохраняют свои примечания об оплате и ID транзакций.
Barion — товарный знак соответствующего правообладателя. Этот плагин не связан с Barion и не одобрен ею.