VibeFox Netopia for WooCommerce — Помощь

Требования

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

WooCommerce: 7.0 или новее, установлен и активен.

PHP: 8.0 или новее с расширениями OpenSSL и DOM.

Валюта: валюта магазина или заказа должна быть RON, EUR, USD или GBP. EUR, USD и GBP должны быть включены в вашей учётной записи Netopia. Для других валют способ оплаты скрыт при оформлении заказа.

Учётная запись Netopia: нужна учётная запись продавца Netopia Payments с точкой продаж. Из технических настроек понадобятся подпись учётной записи и, для каждой используемой среды (тестовой и рабочей), открытый сертификат (.cer) и закрытый ключ (.key). На стороне Netopia ничего настраивать не нужно: адрес IPN передаётся с каждым запросом на оплату.

Публичный сайт: URL для IPN (подтверждения) должен быть доступен из интернета и не находиться за логином, базовой аутентификацией или страницей обслуживания. Заказы обновляются только по IPN от Netopia.

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

Установка

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

2. Нажмите Activate.

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

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

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

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

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

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Netopia Payments. Над полями страница предупреждает, если отсутствует подпись учётной записи, сертификат или закрытый ключ активной среды (тогда способ оплаты скрыт при оформлении заказа), и показывает Test mode is on: payments go to the Netopia sandbox and no real money is charged., пока включён тестовый режим. В списке способов оплаты Netopia помечен как требующий настройки, пока активная среда не заполнена. При сохранении недействительный сертификат или закрытый ключ отклоняются с ошибкой, а предыдущее значение сохраняется.

IPN (confirm) URL

Отображается только для чтения вверху настроек. Выглядит так: https://your-site/wc-api/netopia_payment_callback/. Он передаётся с каждым запросом на оплату как URL подтверждения, поэтому вводить его в административной панели Netopia не нужно. Netopia отправляет IPN на этот адрес; плагин расшифровывает её закрытым ключом активной среды и проверяет подпись вашей учётной записи и запрос на оплату. Netopia сообщает о следующих действиях:

Уведомление с кодом ошибки Netopia (например, при отклонённой карте) переводит неоплаченный заказ в статус Failed. Уведомления, которые нельзя расшифровать, которые содержат другую подпись учётной записи или не относятся к запросу на оплату этого заказа, отклоняются и ничего не меняют.

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

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

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

Description: описание способа оплаты, которое показывается при оформлении заказа. По умолчанию: Pay securely with your credit or debit card via Netopia.

Учётная запись Netopia

В административной панели Netopia перейдите в Seller accounts > your point of sale > Technical settings: скопируйте подпись учётной записи и загрузите открытый сертификат (.cer) и закрытый ключ (.key) каждой среды. Откройте файлы в текстовом редакторе и вставьте их полное содержимое, включая строки BEGIN/END.

Account signature: подпись учётной записи продавца (формат XXXX-XXXX-XXXX-XXXX-XXXX), одинаковая для тестовой и рабочей среды.

Test mode: Use the Netopia sandbox (sandboxsecure.mobilpay.ro) and the sandbox keys. Переключает страницу оплаты и пару ключей. По умолчанию: включено. Отключите, чтобы принимать реальные платежи с рабочими ключами.

Sandbox public certificate (.cer): содержимое файла открытого сертификата тестовой среды. Используется для шифрования запроса на оплату.

Sandbox private key (.key): содержимое файла закрытого ключа тестовой среды. Используется для расшифровки IPN. После сохранения он больше не отображается; поле показывает A private key is saved. Оставьте поле пустым, чтобы сохранить ключ, или вставьте новый ключ для замены.

Live public certificate (.cer): содержимое файла открытого сертификата рабочей среды.

Live private key (.key): содержимое файла закрытого ключа рабочей среды. После сохранения он больше не отображается; оставьте поле пустым, чтобы сохранить ключ.

Заказы

Order status after payment: статус оплаченного заказа, который требует отправки. Заказы только с виртуальными или загружаемыми товарами WooCommerce в любом случае завершает сам. Статус устанавливается одной сменой и одним письмом покупателю.

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

Debug log: Log requests and IPN processing записывает в WooCommerce > Status > Logs, источник wcp_netopia_gateway. Данные карт, ключи и данные покупателей не записываются. Ошибки, например отклонённые IPN, записываются всегда, даже если опция выключена. По умолчанию: выключено.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted (orders are kept). По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Card Payment (Netopia)) и оформляет заказ. Следующая страница показывает Redirecting you to Netopia for secure payment… и автоматически перенаправляет покупателя на страницу оплаты Netopia; запасными являются кнопки Proceed to payment и Cancel order. Запрос на оплату шифруется вашим сертификатом Netopia и содержит сумму заказа в валюте заказа, Order # с номером заказа, а также контактные данные для выставления счёта и доставки. В тестовом режиме запрос уходит в тестовую среду Netopia.

Покупатель оплачивает картой на странице Netopia и возвращается на страницу подтверждения заказа в вашем магазине. Сам возврат не отмечает заказ оплаченным. Заказ отмечается оплаченным только после подтверждения Netopia по IPN. До этого на странице подтверждения заказа показывается Netopia has not confirmed your payment yet. You will receive an e-mail as soon as the payment is confirmed. Для заказа в статусе On hold показывается Your payment is awaiting confirmation. We will e-mail you as soon as the order is confirmed. Если оплата отменена, показывается The payment was cancelled at Netopia, so this order was cancelled. You can place a new order at any time.

Если карта отклонена, заказ переходит в статус Failed, и покупатель может оплатить его снова со страницы заказа. Если плагин настроен неправильно, страница оплаты показывает Netopia gateway is not configured properly. Please contact the store administrator.

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

Плагин принимает платежи картами только по протоколу карточных платежей Netopia v1. Возвраты и списания через WooCommerce не поддерживаются, как и сохранённые карты или оплата в один клик, подписки, рассрочка, SMS, банковские переводы и криптоплатежи, а также Netopia API v2.

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

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

Pending payment: покупатель был перенаправлен в Netopia, или Netopia ещё не отправила IPN.

Processing or Completed: Netopia подтвердила платёж. Статус соответствует настройке Order status after payment. Примечание к заказу показывает сумму, маскированный номер карты и транзакцию Netopia; тестовые платежи отмечены как [sandbox]. ID транзакции — это ID транзакции Netopia.

On hold: платёж является предавторизацией, ожидающей списания в административной панели Netopia, или проверяется в Netopia. Заказ отмечается оплаченным, когда Netopia его подтверждает. Заказ также переводится в On hold, если сумма или валюта счёта в Netopia отличаются от заказа, если списана только часть суммы или если Netopia подтвердила оплату отменённого заказа. Примечание к заказу объясняет причину. Проверьте транзакцию в административной панели Netopia и завершите заказ или оформите возврат вручную.

Failed: Netopia сообщила об ошибке, например об отклонённой карте. Покупатель может оплатить заново.

Cancelled: Netopia отменила платёж, или покупатель нажал Cancel order до перехода в Netopia.

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

Возвраты

Возвраты не оформляются через WooCommerce: протокол карточных платежей Netopia v1 не имеет вызова возврата, поэтому кнопки Refund via нет. Оформите возврат транзакции в административной панели Netopia. Затем Netopia отправит IPN о зачислении, и плагин автоматически зарегистрирует возврат в заказе с причиной Refund initiated by Netopia. Частичные возвраты сохраняют статус заказа; когда возвращать больше нечего, WooCommerce переводит заказ в статус Refunded. Для заказов в EUR, USD и GBP возвращаемая сумма, которую Netopia сообщает в RON, пересчитывается обратно в валюту заказа. Возврат никогда не регистрируется дважды и не превышает оставшуюся сумму. Запасы автоматически не восстанавливаются.

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

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

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

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

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

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

Netopia не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено, активная среда заполнена (Account signature плюс сертификат и закрытый ключ тестовой среды в тестовом режиме либо рабочей среды в рабочем режиме), а валюта магазина или заказа — RON, EUR, USD или GBP. Страница настроек показывает предупреждение, если что-то не заполнено.

Платёж прошёл, но заказ остаётся в статусе Pending payment: IPN не дошла до магазина или была отклонена. Проверьте, что URL IPN (подтверждения) из настроек доступен из интернета (без режима обслуживания, базовой аутентификации и межсетевого экрана, блокирующего запросы). Включите Debug log и найдите строки IPN в WooCommerce > Status > Logs, источник wcp_netopia_gateway. Одно лишь возвращение покупателя никогда не отмечает заказ оплаченным.

Log shows failed decrypting data: закрытый ключ не соответствует сертификату среды, которую использовала Netopia. IPN расшифровывается ключом активной среды, а для платежей, начатых до переключения тестового режима, ключом другой среды. Netopia повторит отправку.

Log shows signature mismatch: Account signature не совпадает с точкой продаж, которая отправила IPN. Скопируйте её заново из административной панели Netopia.

Log shows unknown payment request: IPN не соответствует запросу на оплату, который ваш магазин отправил для этого заказа в этой среде (тестовой или рабочей). Ничего не меняется.

Log shows gateway not configured: отсутствует закрытый ключ или подпись учётной записи. Netopia повторит IPN, и платёж будет зарегистрирован после заполнения настроек.

Error on save about the certificate or private key: вставленный текст не является действительным сертификатом или ключом. Вставьте полное содержимое файла, включая строки BEGIN/END. Предыдущее значение сохранено.

Order is On hold after payment: прочитайте примечание к заказу. Платёж может быть предавторизацией или проверяться, сумма или валюта могли отличаться, списана только часть суммы, заказ был отменён, либо тестовый платёж был подтверждён, когда магазин работал в рабочем режиме (реальные деньги не получены). Проверьте транзакцию в административной панели Netopia.

A refund made in Netopia does not appear on the order: IPN о зачислении не дошла до магазина или была отклонена. Проверьте журнал. При необходимости создайте возврат вручную в WooCommerce.

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

Удаление

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

Netopia Payments и mobilPay являются товарными знаками их владельцев. Этот плагин не связан с Netopia Payments и не одобрен компанией.