VibeFox CorvusPay for WooCommerce — Помощь

Требования

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

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

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

Валюта: AUD, BAM, BHD, CAD, CHF, CZK, DKK, EUR, GBP, HRK, HUF, ISK, MKD, NOK, PLN, RON, RSD, RUB, SEK или USD. В любой другой валюте способ оплаты скрыт на странице оформления заказа. Суммы передаются с 2 десятичными знаками; итог с большим числом десятичных знаков (например, в магазине с BHD, где 3 десятичных знака) отклоняется, а не округляется.

Аккаунт CorvusPay: вам нужен мерчант-аккаунт CorvusPay. CorvusPay выдаёт Store ID и Secret Key для каждого магазина, отдельно для тестового и рабочего; они отображаются в CorvusPay Merchant Center. Success URL и Cancel URL плагина нужно указать там (см. «Настройка»).

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите Store ID и Secret Key вашего тестового магазина CorvusPay (а для реальных платежей — и рабочего магазина). Скопируйте Success URL и Cancel URL, показанные на странице настроек, в CorvusPay Merchant Center — для тестового и рабочего магазина.

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

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > CorvusPay. Над полями страница показывает Test mode is on., пока включён тестовый режим, и предупреждает, если шлюз включён, но Store ID или Secret Key текущего режима не заполнены (тогда он скрыт на странице оформления заказа, пока их не заполнят), а также если валюта магазина не поддерживается CorvusPay.

Основные

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

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

Description: текст, который показывается под способом оплаты на странице оформления заказа. По умолчанию: Pay securely with your credit or debit card via CorvusPay. В тестовом режиме к нему добавляется (Test mode — no real payment is taken.)

Учётные данные магазина

Store ID и Secret Key выдаёт CorvusPay для каждого магазина (отдельно для тестового и рабочего), они отображаются в CorvusPay Merchant Center.

Test Mode: Enable test mode использует тестовую среду CorvusPay (wallet.test.corvuspay.com) и тестовые Store ID и Secret Key. По умолчанию: включено.

Test Store ID: числовой Store ID вашего тестового магазина CorvusPay.

Test Secret Key: Secret Key вашего тестового магазина CorvusPay, используется для подписей HMAC-SHA256.

Live Store ID: числовой Store ID вашего рабочего магазина CorvusPay.

Live Secret Key: Secret Key вашего рабочего магазина CorvusPay, используется для подписей HMAC-SHA256.

Store ID должен содержать только цифры. Если ввести что-либо другое, будет показана ошибка, а прежнее значение сохранится. Платёж всегда проверяется с помощью Secret Key того магазина, в котором он был совершён, поэтому не удаляйте тестовый ключ, пока остаются открытые тестовые заказы.

Success URL и Cancel URL

Скопируйте два адреса, показанные в этом разделе, в CorvusPay Merchant Center — для тестового и рабочего магазина. CorvusPay возвращает покупателя на них после оплаты.

Success URL: выглядит как https://your-site/wc-api/corvuspay_payment_success/. CorvusPay подписывает этот запрос; заказ отмечается оплаченным только после проверки подписи.

Cancel URL: выглядит как https://your-site/wc-api/corvuspay_payment_cancel/. CorvusPay его не подписывает, поэтому он может отменить только неоплаченный заказ с номером заказа CorvusPay, выданным этим магазином.

Оплата

Transaction Type: как списываются средства с карты.

Sale (capture immediately): средства списываются сразу (по умолчанию).

Authorize only (capture in Merchant Center): сумма только резервируется. Заказ переводится в статус «на удержании»; вы выполняете списание (capture) в CorvusPay Merchant Center, затем переводите заказ в статус «Обработка».

Payment Page Language: язык страницы оплаты CorvusPay. Site language (по умолчанию) использует текущий язык вашего сайта, если CorvusPay его поддерживает, иначе — английский. Можно также выбрать хорватский, английский, немецкий, итальянский, сербский или словенский.

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

Processing (WooCommerce default): по умолчанию.

Completed: каждый оплаченный заказ получает статус «Выполнен».

On Hold: каждый оплаченный заказ ждёт вашей ручной проверки.

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

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

Delete Data: Delete the plugin settings and log files when the plugin is deleted (uninstalled). Деактивация ничего не удаляет. Платёжные данные, сохранённые в заказах, остаются всегда. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Credit/Debit Card (CorvusPay)) и оформляет заказ. Заказ остаётся в статусе «Ожидает оплаты», а страница Pay for order показывает Redirecting to CorvusPay for payment. Please wait... и отправляет подписанную форму на страницу оплаты CorvusPay. Если перенаправление не началось, покупатель нажимает Pay via CorvusPay. Передаются сумма заказа, валюта, краткое описание корзины и платёжные данные (чтобы заранее заполнить страницу оплаты). Один и тот же номер заказа CorvusPay используется повторно, пока сумма не меняется, а второй платёж по нему CorvusPay не принимает.

После оплаты CorvusPay возвращает покупателя на Success URL. Заказ отмечается оплаченным только после подтверждения CorvusPay: номер заказа CorvusPay должен быть выдан для этого заказа, подпись должна совпадать с Secret Key того магазина, в котором был совершён платёж, а сумма и валюта должны совпадать с заказом. Затем покупатель попадает на страницу «Заказ получен». Остаток товара уменьшается при подтверждении платежа, а корзина очищается на странице «Заказ получен».

Если покупатель отменяет оплату на странице CorvusPay, неоплаченный заказ отменяется, а покупатель возвращается к оформлению заказа с нетронутой корзиной и сообщением The CorvusPay payment was cancelled and the order was not paid. Your cart is still here — you can try again or choose another payment method. Если платёж был начат со страницы Pay for order и корзина пуста, WooCommerce показывает The CorvusPay payment was cancelled and the order was not paid. на странице корзины. Если запрос на Success URL не удаётся проверить, покупатель видит We could not confirm this CorvusPay payment. If your card was charged, please contact the shop — do not pay again., а заказ не изменяется.

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

Заказ подтверждается только тогда, когда CorvusPay возвращает покупателя на Success URL; уведомлений между серверами нет. Если покупатель закрыл браузер сразу после оплаты, заказ остаётся в статусе «Ожидает оплаты». В плагине нет возвратов, списаний (capture) и отмен авторизации из WooCommerce (серверный API CorvusPay требует клиентский сертификат), сохранённых карт, подписок, рассрочки, IBAN / PIS и CorvusWallet.

Заказы

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

Pending payment: покупатель был перенаправлен в CorvusPay и ещё не вернулся. Если покупатель заплатил, но не вернулся, проверьте платёж в CorvusPay Merchant Center и завершите заказ вручную.

Processing, Completed или On Hold: платёж Sale подтверждён. Статус определяется настройкой Order Status After Payment. В примечании к заказу указаны номер заказа CorvusPay, код авторизации и тип карты. ID транзакции заказа — это ID транзакции CorvusPay или, если CorvusPay его не присылает, номер заказа CorvusPay, по которому платёж можно найти в Merchant Center.

On hold, авторизован: выбран Authorize only. Выполните списание (capture) платежа в CorvusPay Merchant Center, затем переведите заказ в статус «Обработка».

On hold, несовпадение суммы/валюты: оплаченная сумма или валюта не совпадает с заказом. Не отправляйте товар, пока не проверите платёж в CorvusPay Merchant Center.

On hold, платёж по отменённому заказу: успешный платёж поступил после того, как заказ был отменён, например по тайм-ауту неоплаченных заказов. Выполните заказ или верните платёж в CorvusPay Merchant Center.

Cancelled: покупатель отменил оплату на странице CorvusPay.

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

Refunds: возвраты, списания (capture) и отмены авторизации из WooCommerce не поддерживаются. Выполняйте их в CorvusPay Merchant Center и вручную фиксируйте возврат в WooCommerce.

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

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

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

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

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

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

CorvusPay не появляется на странице оформления заказа: проверьте, что лицензия активна, Enable/Disable включён, Store ID и Secret Key текущего режима заполнены (Test Store ID и Test Secret Key в тестовом режиме, Live Store ID и Live Secret Key в рабочем режиме), а валюта магазина поддерживается CorvusPay. В каждом из этих случаев на странице настроек показывается предупреждение.

Платёж прошёл, но заказ остаётся в статусе «Ожидает оплаты»: скорее всего, Success URL не указан в CorvusPay Merchant Center или Secret Key в WooCommerce не соответствует магазину. Включите Logging и найдите INVALID signature в WooCommerce > Status > Logs, источник wcp_corvuspay_gateway. Заказ остаётся неоплаченным и в том случае, если покупатель закрыл браузер до возврата; тогда проверьте платёж в Merchant Center и завершите заказ вручную.

Покупатель видит We could not confirm this CorvusPay payment: запрос на Success URL был отклонён: не хватало обязательных полей, номер заказа CorvusPay не был выдан для этого заказа, Secret Key этого магазина пуст или подпись не совпала. Заказ не изменяется. Причина указана в журнале.

Покупатель видит This order total cannot be paid via CorvusPay: итоговая сумма равна нулю или содержит более 2 десятичных знаков.

Покупатель видит CorvusPay is not configured или CorvusPay does not accept payments in …: не заполнен Store ID или Secret Key текущего режима либо валюта заказа не поддерживается.

Заказ в статусе On hold: прочитайте примечание к заказу. Выбран Authorize only, оплаченная сумма или валюта не совпала с заказом, либо платёж поступил после отмены заказа.

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

Удаление

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

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