VibeFox Windcave for WooCommerce — Помощь

Требования

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

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

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

Аккаунт Windcave: вам нужна учётная запись мерчанта Windcave с учётными данными REST API: имя пользователя API и API-ключ. Windcave выдаёт их отдельно для тестовой среды UAT (uat.windcave.com) и для производственной среды (sec.windcave.com). Запросите их в службе поддержки Windcave или у своего менеджера. Ключи PxPay с этим плагином не работают. Способы оплаты, которые вы хотите предлагать (карты, электронные кошельки и другие), должны быть включены в вашем аккаунте Windcave.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите имя пользователя и ключ REST API: учётные данные UAT для тестового режима, рабочие учётные данные для реальных платежей (см. раздел «Конфигурация»).

6. Выберите тип транзакции и способы оплаты, включите Enable/Disable и сохраните. Сделайте тестовый платёж при включённом Test mode, затем выключите Test mode, чтобы принимать реальные платежи.

Конфигурация

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Windcave. Пока включён тестовый режим, страница показывает Test mode is on: payments go to the Windcave UAT environment and no real money is taken. В списке способов оплаты Windcave помечается как требующий настройки, пока в текущем режиме не заданы имя пользователя API и API-ключ. Версия плагина показана внизу страницы.

Общие

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

Title: название способа оплаты, которое видят покупатели при оформлении заказа. По умолчанию: Credit/Debit Card (Windcave).

Description: текст под способом оплаты при оформлении заказа. По умолчанию: You will be redirected to the secure Windcave payment page to complete your payment.

Windcave REST API

Введите учётные данные REST API, выданные Windcave (имя пользователя и API-ключ, а не ключи PxPay). Рабочие и тестовые учётные данные можно сохранить одновременно. Тестовый режим использует только учётные данные UAT, боевой режим — только рабочие.

Test mode: Use the Windcave UAT test environment (uat.windcave.com). Реальные деньги не списываются. Новые платежи используют учётные данные UAT. Возвраты и списания всегда отправляются в ту среду, в которой был оплачен заказ. По умолчанию: выключено.

Production API username: имя пользователя REST API для sec.windcave.com.

Production API key: ключ REST API для sec.windcave.com.

UAT API username: имя пользователя REST API для uat.windcave.com (тестовый режим).

UAT API key: ключ REST API для uat.windcave.com (тестовый режим).

Оплата

Transaction type: способ списания платежа. По умолчанию: Purchase.

Purchase (capture immediately): деньги списываются в момент оплаты покупателем.

Auth (authorise now, capture later): деньги только резервируются. Заказ переводится в статус «На удержании», а вы списываете деньги действием Capture Windcave payment в действиях заказа или снимаете резерв, возвращая полную сумму. Неподтверждённые авторизации истекают через несколько дней.

Payment methods: способы, которые показываются на странице оплаты Windcave: Cards, Account2Account (банковский перевод в Новой Зеландии), Apple Pay, Google Pay, PayPal, Alipay, WeChat Pay, UnionPay, Interac, humm. Они должны быть включены в вашем аккаунте Windcave. Оставьте поле пустым, чтобы показывать все способы, включённые в аккаунте. По умолчанию: Cards.

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

Debug log: Log API requests and payment events. Журнал находится в WooCommerce > Status > Logs, источник wcp_windcave_payment_gateway. Ошибки и предупреждения записываются всегда; эта опция добавляет запросы к API и события платежей. Ключи API, данные карт и персональные данные покупателей маскируются. По умолчанию: выключено.

Clean uninstall: Delete the plugin settings and logs when the plugin is deleted. Платёжные данные, сохранённые в заказах (идентификаторы транзакций Windcave, нужные для возвратов), всегда сохраняются. По умолчанию: выключено.

URL уведомлений

В Windcave не нужно настраивать URL уведомлений. Плагин передаёт свои адреса возврата и адрес уведомления с каждой платёжной сессией. Windcave отправляет уведомление (Fail-Proof Result Notification) на адрес https://your-site/wc-api/windcave_p_notification/. Ни возврат покупателя, ни уведомление не подписываются Windcave, поэтому плагин никогда не доверяет им сам по себе: он всегда получает результат сессии через REST API Windcave, используя ваши учётные данные той среды, в которой была создана сессия.

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

Покупатель выбирает способ оплаты (по умолчанию Credit/Debit Card (Windcave)) и оформляет заказ. Плагин создаёт платёжную сессию Windcave на сумму заказа в валюте заказа и отправляет покупателя на Windcave Hosted Payment Page. Номер заказа передаётся как референс мерчанта вместе с языком магазина, именем, адресом электронной почты, телефоном и адресами выставления счёта и доставки покупателя. В тестовом режиме блок «Оформление заказа» показывает под способом оплаты надпись Test mode: payments go to the Windcave UAT environment, no real money is taken.

После оплаты покупатель возвращается на страницу «Заказ получен» вашего магазина. Заказ помечается оплаченным только после подтверждения Windcave: плагин запрашивает у REST API Windcave результат сессии как при возврате покупателя, так и при получении уведомления от Windcave. Блокировка на каждый заказ гарантирует, что платёж будет применён только один раз. Если результат ещё не известен, страница «Заказ получен» проверяет его ещё раз и показывает We are waiting for Windcave to confirm your payment. You will receive an e-mail as soon as it is confirmed — please do not pay again.

Если покупатель вернулся без завершённой оплаты, на странице оформления заказа (или на странице Pay for order, если попытка началась там) показывается одно из следующих сообщений:

Declined: ваш платёж был отклонён. Попробуйте снова или выберите другой способ оплаты.

Cancelled or expired: платёж не был завершён на странице Windcave. Ваш заказ сохранён: вы можете повторить попытку или выбрать другой способ оплаты.

Not confirmed yet: мы пока не смогли подтвердить ваш платёж. Если вы его завершили, не оплачивайте повторно: письмо с подтверждением придёт, как только Windcave подтвердит платёж.

Return could not be processed: мы не смогли обработать ваш возврат со страницы оплаты. Если с вас списали деньги, свяжитесь с нами, прежде чем платить снова.

Корзина не очищается и остаток товара не уменьшается до оплаты покупателем. Покупатель может повторно оплатить неоплаченный заказ, например со страницы Pay for order. Новая попытка сначала проверяет предыдущую сессию: если она уже оплачена, второй платёж не создаётся; если покупатель не пользовался страницей оплаты и заказ не изменился, его возвращают на ту же страницу. Если предыдущий платёж в этот момент подтверждается, покупатель видит Your previous payment for this order is being confirmed right now. Please wait a minute and check your e-mail before trying again.

Если Windcave не может начать платёж, покупатель видит короткое сообщение: что Windcave не смог начать платёж с данными этого заказа или что платёжный сервис временно недоступен. Причина добавляется в примечания к заказу. Если в текущем режиме нет учётных данных, покупатель видит This payment method is not available at the moment. Please choose another payment method or contact us.

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

В плагине нет подписок и периодических платежей, сохранённых карт, встроенной формы карты на вашем сайте (покупатель всегда платит на странице Windcave), поддержки API PxPay 2.0, и он не добавляет наценок. Если Windcave добавляет наценку, заказ сопоставляется с основной транзакцией.

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

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

Pending payment: покупатель перенаправлен в Windcave и ещё не оплатил, либо Windcave ещё не подтвердил платёж. Если покупатель отменит оплату или сессия истечёт, заказ остаётся в статусе «Ожидает оплаты», и добавляется примечание.

Processing or Completed: платёж типа Purchase подтверждён. WooCommerce ставит статус «В обработке» или, для заказов без доставки, «Выполнен», как обычно. В примечании к заказу указаны сумма, идентификатор транзакции Windcave, код авторизации, тип карты с замаскированным номером и среда (UAT или производственная). Идентификатор транзакции заказа — это идентификатор транзакции Windcave.

On hold (authorised): платёж Auth одобрен, но ещё не списан. В примечании к заказу объясняется, как его списать или снять резерв.

On hold (does not match): Windcave сообщил сумму, валюту, референс мерчанта или тип транзакции, отличающиеся от заказа (например, заказ был изменён после начала оплаты). В примечании перечислены расхождения. Проверьте платёж в Windcave Payline перед отправкой и при необходимости сделайте возврат.

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

Если одобренный платёж поступает для отменённого заказа или второй одобренный платёж поступает для уже оплаченного заказа, заказ не меняется. Примечание с идентификатором транзакции предлагает вам сделать возврат в Windcave Payline (или восстановить отменённый заказ вручную).

Списание (режим Auth)

Откройте заказ, выберите Capture Windcave payment в действиях заказа и нажмите кнопку обновления. Действие появляется только у заказа в статусе «На удержании» с авторизацией, которая ещё не списана и не снята. Списывается вся сумма заказа, списание добавляется в примечания, а заказ переходит в статус оплаченного (обычно «В обработке»). Если Windcave не принимает списание, на экране заказа появляется Windcave capture failed: с причиной, и причина добавляется в примечания к заказу.

Возвраты

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

Для неподтверждённого платежа Auth возможен только полный возврат: он снимает (аннулирует) авторизацию. Частичная сумма вызывает ошибку с просьбой вернуть полную сумму или сначала списать платёж.

Если Windcave отклоняет возврат, WooCommerce показывает Windcave declined the refund: с причиной, и возврат не регистрируется. Если Windcave ещё обрабатывает возврат, WooCommerce показывает Windcave has not confirmed the refund yet. See the order notes., и возврат не регистрируется. Проверьте транзакцию в Windcave Payline: если она одобрена, зарегистрируйте возврат вручную; иначе повторите попытку. Повторная попытка того же возврата не отправляется в Windcave дважды. Возвраты, сделанные в Windcave Payline, в магазин не передаются.

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

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

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

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

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

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

Windcave does not appear at checkout: проверьте, что лицензия активна, Enable/Disable включён и в текущем режиме заданы оба набора учётных данных: UAT API username и UAT API key в тестовом режиме, Production API username и Production API key в боевом режиме.

The payment went through, but the order stays Pending payment: плагин ещё не смог получить результат от Windcave. Откройте примечания к заказу: в одном из них указано, когда сессию не удалось проверить и почему. Убедитесь, что учётные данные среды, в которой прошёл платёж, сохранены и правильны. Проверка повторяется, когда Windcave заново отправляет уведомление (плагин отвечает ошибкой, пока результат не может быть проверен, чтобы Windcave повторил отправку), и когда покупатель открывает страницу «Заказ получен». Ваш сервер должен принимать запросы от Windcave на адрес https://your-site/wc-api/windcave_p_notification/.

Authentication failed in the order notes or the log: имя пользователя или ключ REST API неверны либо относятся к другой среде. Учётные данные UAT работают только в тестовом режиме, рабочие — только в боевом. Ключи PxPay не работают.

The customer sees that Windcave could not start the payment with the details of this order: Windcave отклонил запрос сессии, например из-за валюты или способа оплаты, не включённого в вашем аккаунте. Точная причина указана в примечаниях к заказу и в журнале.

Order is On hold after payment: прочитайте примечание к заказу. Либо платёж — это Auth, ожидающий списания, либо оплаченная сумма, валюта или референс мерчанта не совпали с заказом. Спишите, выполните или возвратите платёж.

Test payments and live payments: UAT и производственная среда разделены. Каждая сессия проверяется в той среде, в которой была создана, а возвраты и списания отправляются в среду платежа, даже если вы позже переключите Test mode. Заказы, созданные версией 1.0 плагина, используют среду прежней настройки API URL.

Refund fails with a message about the environment: платёж был совершён в UAT или в производственной среде, а учётные данные этой среды не сохранены. Введите их и повторите попытку.

Capture Windcave payment is missing in the order actions: действие показывается только для заказов в статусе «На удержании», оплаченных через Auth, которые ещё не списаны и не сняты.

Where to find details: ошибки и предупреждения всегда записываются в WooCommerce > Status > Logs, источник wcp_windcave_payment_gateway. Включите Debug log, чтобы также записывать запросы к API и события платежей.

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

Удаление

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

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