VibeFox PayPlug for WooCommerce — Помощь

Требования

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

WooCommerce: 7.0 или новее, установлен и активен. Без него плагин не активируется.

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

Валюта и суммы: евро (EUR), от 0,99 до 20 000,00 за платёж — значения PayPlug по умолчанию. При другой валюте или за пределами этих лимитов способ оплаты скрывается.

Аккаунт PayPlug: нужны секретные ключи вашего аккаунта PayPlug: тестовый ключ (sk_test_...) и/или рабочий ключ (sk_live_...). Никаких других ключей не требуется, и в PayPlug не нужно настраивать уведомления. Ваш сайт должен быть доступен из интернета, чтобы получать уведомления; иначе заказы обновляются, когда покупатель возвращается из PayPlug.

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

Установка

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

2. Нажмите Activate.

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

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

5. Вставьте секретные ключи из портала PayPlug (см. раздел «Настройка»).

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

Настройка

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

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

Enable/Disable: Enable PayPlug Gateway включает или выключает способ оплаты. По умолчанию: off.

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

Description: текст под способом оплаты на оформлении заказа. По умолчанию: Pay securely by card via PayPlug.

API-ключи

Секретные ключи находятся в портале PayPlug в разделе Developers > API keys. Там же отображается адрес уведомлений, который плагин передаёт с каждым платежом. Он выглядит так: https://your-site/wc-api/ppg_payplug_webhook/. В PayPlug настраивать уведомления не нужно.

Test Mode: Enable test mode использует тестовый секретный ключ для новых платежей. Реальные платежи не обрабатываются. Платежи, созданные в другом режиме, для проверки статуса и возвратов по-прежнему используют ключ своего режима. По умолчанию: on.

Test Secret Key: ваш тестовый секретный ключ PayPlug. Он начинается с sk_test_.

Live Secret Key: ваш рабочий секретный ключ PayPlug. Он начинается с sk_live_.

Ключ с неверным префиксом не сохраняется. Страница показывает, например, сообщение Test Secret Key должен начинаться с «sk_test_». Предыдущее значение сохранено.

Заказы

Order Status After Payment: статус заказа, который устанавливается после успешной оплаты. Статус устанавливается сразу, без второй смены статуса.

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

Logging: Enable debug logging записывает вызовы API и уведомления в WooCommerce > Status > Logs с источником wcp_payplug_gateway. Ошибки записываются всегда. Секретные ключи, данные карт и данные покупателей никогда не записываются. По умолчанию: off.

Delete Data on Uninstall: Remove all plugin data when uninstalling. Если опция включена, при удалении плагина удаляются его настройки и журналы. Идентификаторы платежей PayPlug, сохранённые в заказах, остаются. По умолчанию: off.

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

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

После оплаты покупатель возвращается в ваш магазин. Заказ помечается оплаченным только после подтверждения PayPlug: плагин получает данные платежа из API PayPlug, когда приходит уведомление и когда покупатель возвращается. Успешный платёж ведёт покупателя на страницу подтверждения заказа.

Если покупатель отменяет оплату на странице PayPlug, страница оплаты закрывается в PayPlug, поэтому её нельзя случайно оплатить позже. Покупатель возвращается на страницу Pay for order с сообщением, например Вы отменили платёж PayPlug. Вы можете попробовать ещё раз или выбрать другой способ оплаты., Сессия оплаты PayPlug истекла. Попробуйте ещё раз или выберите другой способ оплаты. или Платёж PayPlug не прошёл. Попробуйте ещё раз или выберите другой способ оплаты.

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

Если PayPlug не может начать платёж, покупатель видит короткое сообщение, например PayPlug не принял ваши платёжные данные (почтовый индекс). Проверьте их и попробуйте снова. или Не удалось связаться с платёжным провайдером. Попробуйте ещё раз через минуту. Техническая причина добавляется в примечания к заказу.

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

Платежи списываются сразу. Плагин не поддерживает рассрочку Oney, Bancontact, Apple Pay и American Express, сохранённые карты для оплаты в один клик, встроенную форму оплаты, подписки и отложенное списание.

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

Order statuses

Pending payment: покупатель был перенаправлен в PayPlug и ещё не оплатил заказ, или PayPlug ещё не подтвердил платёж.

Processing or Completed: платёж подтверждён. Статус соответствует Order Status After Payment. В примечании к заказу указаны платёж PayPlug и его режим. Идентификатор транзакции — это идентификатор платежа PayPlug (pay_...).

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

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

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

Возвраты

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

Возвраты, выполненные в портале PayPlug, приходят через уведомления и добавляются в примечания к заказу. В WooCommerce они не создаются автоматически. При необходимости оформите их вручную.

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

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

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

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

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

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

PayPlug не появляется на оформлении заказа: проверьте, что лицензия активна, включён Enable/Disable, у текущего режима есть секретный ключ (Test Secret Key в тестовом режиме, Live Secret Key в рабочем режиме), валюта магазина — EUR, а сумма заказа от 0,99 до 20 000,00 EUR. Аккаунты с другими лимитами могут изменить их с помощью фильтра ppg_amount_limits (значения в копейках).

Платёж прошёл, но заказ остаётся в статусе «Ожидает оплаты»: уведомление не дошло до вашего магазина, а покупатель не вернулся. Проверьте, доступен ли ваш сайт из интернета по адресу уведомлений, указанному в настройках, например не блокирует ли его режим обслуживания, файрвол или защита паролем. Посмотрите WooCommerce > Status > Logs, источник wcp_payplug_gateway, чтобы найти отклонённые уведомления.

Уведомление отвечает Verification failed: данные платежа не удалось получить из API PayPlug, например потому что PayPlug не ответил. Заказ не меняется, и PayPlug отправит уведомление повторно.

Уведомление отвечает Busy, retry: заказ в этот момент обновлял другой запрос, например возврат покупателя. PayPlug отправит уведомление повторно.

Уведомление отвечает Unknown payment или Payment does not belong to the order: платёж был создан не этим магазином или не для этого заказа, например платёж другого магазина на том же аккаунте PayPlug. Он игнорируется.

Покупатель видит Payment could not be initiated: предыдущая попытка оплаты заказа в этот момент подтверждается, или PayPlug отклонил запрос. Подождите немного и попробуйте снова; в примечаниях к заказу показана ошибка PayPlug.

Заказ в статусе «На удержании» после оплаты: прочитайте примечание к заказу. Оплаченная сумма или валюта не совпали с заказом, тестовый платёж был выполнен в рабочем режиме, или платёж поступил после отмены заказа. Обработайте заказ или верните платёж.

Возврат не проходит с сообщением о режиме: платёж был совершён в тестовом или рабочем режиме, а секретный ключ этого режима не задан. Введите его и попробуйте снова.

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

Удаление

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

PayPlug — товарный знак его владельца. Этот плагин не связан с PayPlug и не одобрен компанией PayPlug.