VibeFox Paysera for WooCommerce — Помощь
Требования
WordPress: 6.0 или новее.
WooCommerce: 7.0 или новее, установлен и активен. Без него плагин не активируется.
PHP: 8.0 или новее.
Проект Paysera: нужны идентификатор проекта и пароль проекта (ключ подписи) вашего проекта Paysera. Способы оплаты, которые видит покупатель, — это способы, включённые в этом проекте. В Paysera для callback-уведомления ничего настраивать не нужно: его URL передаётся с каждым запросом на оплату.
Доступный сайт: заказы оплачиваются через callback-уведомление Paysera, поэтому ваш сайт должен быть доступен из интернета, а не находиться за логином, режимом обслуживания или файрволом.
Лицензионный ключ VibeFox: приобретается на vibefox.net. Один ключ работает на одном домене.
Установка
1. В WordPress откройте Plugins > Add New > Upload Plugin, выберите ZIP-архив плагина и нажмите Install Now. Также можно загрузить папку wcp_paysera_payment в /wp-content/plugins/ по FTP.
2. Нажмите Activate.
3. Откройте настройки: WooCommerce > Settings > Payments > Paysera > Manage или нажмите Settings под названием плагина на странице «Плагины».
4. Введите лицензионный ключ VibeFox в блоке лицензии вверху страницы и нажмите Activate.
5. Введите Project ID и Project password из вашего личного кабинета Paysera (см. раздел «Настройка»).
6. По желанию: включите Allow test payments в проекте Paysera и Test payments в плагине, чтобы проверить процесс без списания денег. Выключите перед началом продаж.
7. Включите Enable/Disable и сохраните.
Настройка
Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Paysera. Над полями страница показывает сообщение Paysera скрыт на оформлении заказа, пока не введены Project ID и Project password., если одно из полей не заполнено, а также уведомление о том, что покупателей не списывают, пока включены тестовые платежи или песочница. В списке способов оплаты Paysera помечается как требующий настройки, пока проект не настроен, а при включённых тестовых платежах или песочнице отображается метка тестового режима.
Общие
Enable/Disable: Enable Paysera Payment включает или выключает способ оплаты. По умолчанию: выключено.
Title: название способа оплаты, которое видит покупатель на оформлении заказа. По умолчанию: Paysera.
Description: текст под способом оплаты на оформлении заказа. По умолчанию: Pay securely via Paysera.
Проект Paysera
Project ID и Project password находятся в вашем личном кабинете Paysera в разделе Projects and activities, выберите свой проект, затем General project settings. В этом разделе указан URL callback-уведомления, он выглядит так: https://your-site/wc-api/wc_psr_payment/. Он передаётся автоматически с каждым платежом; в Paysera ничего настраивать не нужно.
Project ID: числовой идентификатор вашего проекта Paysera.
Project password: пароль проекта (ключ подписи). Им подписываются запросы на оплату и проверяются callback-уведомления Paysera.
Тестирование
Test payments: Send payments in test mode (no money is charged). Paysera возвращает успешный тестовый платёж без списания средств с покупателя. Сначала включите Allow test payments в настройках проекта Paysera. Пока эта опция включена, тестовые платежи помечают заказы как оплаченные; когда она выключена, тестовый платёж никогда не оплачивает заказ. По умолчанию: выключено.
Environment: куда отправляется покупатель. Для обычного проекта Paysera оставьте Production, в том числе для тестовых платежей. По умолчанию: Production.
Дополнительно
Debug log: Log payment events. Ошибки записываются всегда. Журналы находятся в WooCommerce > Status > Logs, источник wcp_paysera_payment. Пароли и данные покупателей никогда не записываются. По умолчанию: выключено.
Delete data: Delete the plugin settings and logs when the plugin is deleted. Деактивация плагина ничего не удаляет. Данные заказов всегда сохраняются. По умолчанию: выключено.
Оформление заказа
Покупатель выбирает способ оплаты (по умолчанию Paysera) и оформляет заказ. Когда тестовые платежи включены, на оформлении заказа отображается ТЕСТОВЫЙ РЕЖИМ — деньги не будут списаны. Плагин формирует подписанный запрос на оплату с суммой заказа в минимальных единицах валюты заказа, именем, адресом электронной почты и платёжным адресом покупателя, а также языком, выбранным по языку вашего сайта (литовский, латышский, эстонский, русский, немецкий, польский, в остальных случаях английский). Покупатель переходит в платёжное окно Paysera и выбирает там банк, карту или другой способ.
После оплаты покупатель возвращается на страницу «Заказ получен». Заказ помечается как оплаченный только при поступлении подписанного callback-уведомления Paysera; сам возврат никогда не оплачивает заказ.
Если покупатель отменяет оплату в окне Paysera, заказ отменяется стандартным для WooCommerce способом, и покупатель может оформить заказ снова. Если платёж не удалось начать, покупатель видит сообщение Платежи Paysera временно недоступны. Выберите другой способ оплаты. Причина записывается в журнал.
Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с WooCommerce High-Performance Order Storage (HPOS).
Плагин не поддерживает возвраты из WooCommerce, не предлагает выбор банка или способа оплаты на оформлении заказа, а также не поддерживает подписки, сохранённые карты и курьерские или доставочные службы Paysera.
Заказы
Статусы заказа
Pending payment: покупатель перенаправлен на Paysera, а callback-уведомление ещё не пришло.
Processing: Paysera подтвердил платёж (статус 1). Заказы, содержащие только виртуальные загружаемые товары, переходят в статус «Выполнен» — значение WooCommerce по умолчанию. В примечании к заказу указаны запрос Paysera и способ оплаты. Идентификатор транзакции — это идентификатор запроса Paysera.
On hold: Paysera принял платёжный ордер, но ещё не исполнил его (статус 2), и заказ будет завершён, когда Paysera подтвердит платёж; либо оплаченные сумма или валюта не совпадают с заказом (примечание amount/currency mismatch); либо получен ТЕСТОВЫЙ платёж, когда тестовые платежи были выключены, поэтому деньги не списаны. Примечание к заказу объясняет причину.
Cancelled: покупатель отменил оплату в окне Paysera, либо заказ отменили вы или истёк срок резерва товара. Подтверждённый позже платёж за отменённый заказ не меняет его статус: примечание предлагает восстановить заказ (перевести в статус «В обработке») или вернуть платёж в Paysera.
Другие статусы Paysera (платёж не исполнен, дополнительная информация) только добавляют примечание. Если для уже оплаченного заказа поступает ещё один успешный платёж, заказ не меняется, а примечание предлагает вернуть дубликат в личном кабинете Paysera.
Возвраты
Возвраты из WooCommerce не поддерживаются: протокол платёжного окна Paysera не имеет API для возвратов. Оформляйте возвраты в личном кабинете Paysera. Когда Paysera сообщает о возврате, к заказу добавляется примечание с возвращённой суммой, а статус заказа не меняется. При необходимости зафиксируйте возврат в WooCommerce вручную.
Лицензионный ключ
Плагин работает с лицензионным ключом VibeFox с сайта vibefox.net. Блок лицензии находится вверху страницы WooCommerce > Settings > Payments > Paysera. Вставьте ключ в поле License key и нажмите Activate. В блоке отображается статус, например дата окончания действия лицензии и ваш домен. Кнопкой Check now можно повторно проверить статус, Change key позволяет ввести другой ключ, а Remove key удаляет его с этого сайта. Ссылка Manage licenses and domains in your account открывает ваш личный кабинет на vibefox.net.
Один ключ работает на одном домене. Удаление ключа с сайта не освобождает место под домен. Освободите его в личном кабинете vibefox.net.
Без действующего ключа Paysera не отображается покупателям на оформлении заказа. Если платёж всё же начат, покупатель видит сообщение This payment method is not available. Please choose another one. Авторизованные администраторы магазина по-прежнему видят способ оплаты с пометкой (unlicensed — visible to admins only), чтобы вы могли настроить и проверить плагин до покупки ключа. Напоминание появляется на странице «Плагины» и на страницах WooCommerce. Существующие заказы не затрагиваются: уже начатые платежи по-прежнему подтверждаются.
Когда срок лицензии истекает, плагин продолжает работать, но для обновлений и поддержки нужно продление. Статус автоматически проверяется в фоновом режиме.
Устранение неполадок
Paysera не появляется на оформлении заказа: проверьте, что лицензия активна, что Enable/Disable включён и что заполнены Project ID и Project password. Страница настроек показывает предупреждение, пока одно из полей не заполнено.
Платёж прошёл, но заказ остаётся в статусе Pending payment: заказ оплачивается через callback-уведомление Paysera, а не через возврат покупателя. Проверьте, что ваш сайт доступен из интернета по URL callback-уведомления, указанному в настройках (не за логином, режимом обслуживания или файрволом), и посмотрите WooCommerce > Status > Logs, источник wcp_paysera_payment.
Callback отвечает Invalid signature: Project password не соответствует проекту, либо callback-уведомление не от Paysera. Скопируйте пароль проекта заново.
Callback отвечает Project ID mismatch: Project ID в настройках отличается от проекта, который совершил платёж.
Callback отвечает Gateway not configured или Busy: идентификатор или пароль проекта пусты, либо для того же заказа ещё выполняется другой callback. Paysera повторяет callback-уведомление.
Paysera отклоняет платёжное окно или сообщает, что проект не существует: проверьте Environment. Обычный проект Paysera работает только с Production; для Sandbox нужен проект, созданный в песочнице Paysera.
Тестовый платёж не оплачивает заказ: ТЕСТОВЫЙ платёж оплачивает заказ только при включённой опции Test payments. Иначе заказ переводится в статус «На удержании» с примечанием, что деньги не списаны. Также включите Allow test payments в проекте Paysera.
На оформлении заказа не видно значка: плагин по умолчанию не показывает значок. Разработчики могут задать его фильтром wc_psr_gateway_icon.
Заказ в статусе On hold с примечанием о расхождении суммы или валюты: Paysera подтвердил платёж, сумма или валюта которого не совпадает с суммой заказа, например потому, что заказ был изменён после того, как покупатель начал оплату. Сверьте платёж в личном кабинете Paysera и завершите или вручную верните заказ.
Блок лицензии показывает ошибку: следуйте сообщению в блоке. Например, если ключ уже используется на другом домене, освободите место в личном кабинете vibefox.net и нажмите Check now. Если адрес сайта изменился, нажмите Check now, чтобы активировать ключ для нового домена. Если сервер лицензий недоступен, плагин продолжает работать по последнему известному статусу.
Удаление
Деактивация плагина сохраняет все данные. Чтобы удалить его, деактивируйте и удалите плагин на странице Plugins. Лицензионный ключ и статус лицензии этого плагина удаляются всегда. Настройки платёжного шлюза и журналы удаляются, только если была включена опция Delete data. Иначе они сохраняются для повторной установки. Существующие заказы сохраняют примечания об оплате и идентификаторы транзакций.
Paysera является товарным знаком своего правообладателя. Этот плагин не связан с Paysera и не одобрен компанией Paysera.