VibeFox Nets Nexi for WooCommerce — Помощь

Требования

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

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

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

Учётная запись Nets: нужны секретные ключи вашей учётной записи Nets Easy (тестовый и рабочий). Используются только секретные ключи. Ключи для checkout не нужны, так как покупатели платят на размещённой странице оплаты Nets.

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

HTTPS для вебхуков: Nets вызывает только публичные адреса HTTPS длиной не более 256 символов и без «&», поэтому для получения вебхуков сайту нужны HTTPS и понятные постоянные ссылки. На других сайтах платёж всё равно подтверждается, когда покупатель возвращается в магазин, или через действие с заказом.

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

Установка

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

2. Нажмите Activate.

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

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

5. Скопируйте тестовый секретный ключ из тестового портала Nets Easy и вставьте его в поле Test Secret Key (см. раздел Конфигурация).

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

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

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Nets Nexi (Nordics). Над полями страница предупреждает, если отсутствует секретный ключ выбранного режима (тогда способ оплаты скрыт при оформлении заказа), и показывает Nets Nexi is in test mode: payments go to the Nets test environment and no real money is charged., пока включён тестовый режим. В списке способов оплаты Nets Nexi помечен как требующий настройки, пока в выбранном режиме нет секретного ключа.

Общие

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

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

Description: описание способа оплаты, которое видит покупатель при оформлении заказа. По умолчанию: Pay securely with Nets Easy.

Ключи API

Скопируйте секретные ключи из портала Nets Easy в разделе Company > Integration: тестовый портал (test.portal.dibspayment.eu) для тестового ключа и рабочий портал (portal.dibspayment.eu) для рабочего ключа. Ключи для checkout не нужны.

Test Mode: Enable test mode. Тестовый режим использует test.api.dibspayment.eu с тестовым секретным ключом; рабочий режим использует api.dibspayment.eu с рабочим секретным ключом. Возвраты и списания заказа всегда выполняются в той среде, в которой он был оплачен. По умолчанию: включено.

Test Secret Key: ваш секретный ключ API тестовой среды Nets.

Live Secret Key: ваш секретный ключ API рабочей среды Nets.

Оплата

Уведомления Nets (вебхуки) регистрируются автоматически при каждом платеже. В портале Nets ничего настраивать не нужно. Этот раздел показывает URL вебхука. Он выглядит так: https://your-site/wc-api/nng_nets_nexi/. Если URL не является публичным адресом HTTPS, раздел предупреждает, что сайт не получает вебхуки; тогда платежи подтверждаются, когда покупатель возвращается в магазин, или с помощью действия с заказом Nets: check payment status and capture. Регистрируются следующие события:

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

Order Status After Payment: статус заказа после того, как Nets подтвердила и списала платёж. Статус устанавливается сразу, поэтому покупатель получает одно письмо.

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

Debug log: Enable debug logging записывает вызовы API и изменения статусов платежей в WooCommerce > Status > Logs, источник wcp_nets_nexi_gateway. Ошибки записываются всегда. Ключи и данные покупателей не записываются. По умолчанию: выключено.

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

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

Покупатель выбирает способ оплаты (по умолчанию Nets Easy) и оформляет заказ. Плагин создаёт платёж Nets с позициями заказа, доставкой и комиссиями в валюте заказа и отправляет покупателя на размещённую страницу оплаты Nets. Адрес электронной почты, имя, адрес и телефон покупателя передаются в Nets, если Nets принимает их формат; на странице Nets выводится ссылка на ваши условия использования. В тестовом режиме при оформлении заказа отображается Test mode: no real money will be charged.

Покупатель оплачивает заказ и возвращается на страницу подтверждения заказа в вашем магазине. Заказ отмечается оплаченным только после подтверждения Nets: плагин получает платёж из API Nets, сравнивает зарезервированную сумму и валюту с заказом, списывает резервирование и только затем завершает заказ. Это происходит по вебхуку, при возвращении покупателя на страницу подтверждения заказа или с помощью действия с заказом Nets: check payment status and capture.

Если покупатель отменяет оплату на странице Nets, он возвращается к оформлению заказа или на страницу Pay for order с сообщением The Nets payment was cancelled. You can try again or choose another payment method. Покупатель может повторно оплатить неоплаченный заказ. Плагин сначала проверяет предыдущий платёж; если он уже оплачен, заказ подтверждается. Иначе предыдущая сессия Nets закрывается, прежде чем начнётся новая. Если платёж по заказу удержан для проверки магазином, покупатель видит A payment for this order is already being reviewed by the shop. Please contact us instead of paying again.

Если Nets не может начать платёж, покупатель видит короткое сообщение, например Nets could not start the payment with the details of this order. Please check your address and phone number, or choose another payment method. или The payment service could not be reached. Please try again in a moment. Подробности записываются в журнал.

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

Плагин использует только размещённую страницу оплаты. В нём нет встроенной на страницу формы оплаты Nets, подписок и регулярных платежей, сохранённых карт, комиссий за оплату по счёту, режима только авторизации и частичных списаний по отправкам.

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

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

Pending payment: покупатель был перенаправлен в Nets и ещё не оплатил. В примечании к заказу указаны ID платежа Nets, сумма и среда.

Processing or Completed: Nets подтвердила и списала платёж. Статус соответствует настройке Order Status After Payment. В примечании к заказу указаны ID платежа, ID списания и способ оплаты. ID транзакции — это ID платежа Nets.

On hold: сумма или валюта в Nets отличаются от заказа (не списано), списание отклонено или покупатель оплатил после отмены заказа (зарезервировано, не списано). Примечание к заказу объясняет причину. После проверки заказа выполните списание действием Nets: check payment status and capture или отмените резервирование в портале Nets.

Cancelled: резервирование последнего платежа заказа отменено, например в портале Nets.

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

Действие с заказом

Для неоплаченных заказов с платежом Nets в списке действий с заказом есть Nets: check payment status and capture. Оно получает платёж из Nets и списывает подходящее резервирование. Если ничего не изменилось, примечание объяснит причину, например что покупатель ещё не завершил оплату.

Возвраты

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

Возвраты, оформленные непосредственно в портале Nets, не превращаются в возвраты WooCommerce. Если нужно, создайте ручной возврат в WooCommerce без использования Refund via Nets Easy.

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

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

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

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

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

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

Nets Nexi не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено и в выбранном режиме есть секретный ключ: Test Secret Key в тестовом режиме, Live Secret Key в рабочем режиме. Страница настроек показывает предупреждение, если ключ отсутствует.

Платёж прошёл, но заказ остаётся в статусе Pending payment: вебхук не дошёл до вашего магазина. Проверьте, что сайт использует HTTPS и понятные постоянные ссылки, чтобы URL вебхука в разделе Payment был публичным адресом HTTPS без «&», и что задан секретный ключ среды платежа. Затем используйте действие с заказом Nets: check payment status and capture. Заказ также подтверждается, когда покупатель возвращается на страницу подтверждения заказа.

Webhook answers Unauthorized: вебхук не содержал секрет этого заказа. Вебхуки принимаются только с секретом, зарегистрированным при платеже.

Webhook answers Busy, retry later, Payment lookup failed или Payment not reserved yet: другой запрос обновлял заказ, API Nets был недоступен или резервирование ещё не было видно. Nets повторит вебхук автоматически.

Покупатель видит ошибку при оформлении заказа: включите Debug log и посмотрите WooCommerce > Status > Logs, источник wcp_nets_nexi_gateway. This payment method is temporarily unavailable. Please choose another payment method. обычно означает неверный или отсутствующий секретный ключ. Отклонённую валюту Nets указывает в журнале.

Order is On hold after payment: прочитайте примечание к заказу. Если списание отклонено, повторите его действием Nets: check payment status and capture или спишите в портале Nets. Если сумма или валюта отличаются, проверьте платёж в портале Nets. Если покупатель оплатил после отмены, проверьте заказ и списите или отмените резервирование.

Refund via Nets Easy отсутствует или не работает: возвраты возможны только после списания платежа. Проверьте в примечании к заказу, что списание есть. Возврат использует секретный ключ среды, в которой был оплачен заказ, поэтому этот ключ должен быть задан.

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

Удаление

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

Nets, Nets Easy и Nexi являются товарными знаками их владельцев. Этот плагин не связан с Nets или Nexi и не одобрен ими.