VibeFox SimplePay for WooCommerce — Помощь

Требования

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

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

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

Валюта магазина: HUF, EUR или USD. SimplePay не принимает другие валюты, и способ оплаты для них не предлагается.

Учётные записи мерчанта SimplePay: SimplePay выдаёт отдельную учётную запись мерчанта для каждой валюты и отдельные учётные записи для рабочего и тестового режимов. Для каждой учётной записи нужны её MERCHANT и SECRET KEY из кабинета мерчанта SimplePay (admin.simplepay.hu для рабочего режима, sandbox.simplepay.hu для тестового), учётная запись > Технические данные. Если вы продаёте только в HUF, достаточно учётной записи HUF. Другие ключи не нужны.

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

Установка

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

2. Нажмите Activate.

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

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

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

6. Скопируйте IPN URL, показанный на странице настроек, в каждую учётную запись мерчанта (рабочую и тестовую) в кабинете SimplePay.

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

При обновлении с версии 1.0 единые Merchant ID и Secret key версии 1.0 переносятся в учётную запись валюты магазина в том режиме, который был активен (тестовый или рабочий). Проверьте учётные записи после обновления.

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

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

Общие

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

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

Description: текст под способом оплаты на странице оформления заказа. По умолчанию: Pay securely with your credit or debit card via SimplePay. Венгерские мерчанты должны показывать при оформлении заказа декларацию о передаче данных SimplePay (Adattovábbítási nyilatkozat). Её можно указать здесь, вместе со ссылкой.

Sandbox mode: Use the SimplePay sandbox направляет платежи в тестовую среду SimplePay и использует тестовые учётные записи. Переключаются и адрес API, и учётные записи мерчанта. Реальные деньги не списываются. По умолчанию: включено. Снимите отметку, чтобы принимать реальные платежи по рабочим учётным записям.

Учётные записи мерчанта для рабочего режима

Учётные записи, которые используются, когда Sandbox mode выключен. Заполните учётные записи валют, в которых продаёт ваш магазин. Значения MERCHANT и SECRET KEY находятся в кабинете мерчанта SimplePay (admin.simplepay.hu), учётная запись > Технические данные. Учётная запись используется только тогда, когда заполнены оба поля.

HUF account — Merchant ID: MERCHANT вашей рабочей учётной записи HUF.

HUF account — Secret key: SECRET KEY вашей рабочей учётной записи HUF.

EUR account — Merchant ID и EUR account — Secret key: то же самое для вашей рабочей учётной записи EUR.

USD account — Merchant ID и USD account — Secret key: то же самое для вашей рабочей учётной записи USD.

Учётные записи мерчанта для тестовой среды

Учётные записи, которые используются, когда Sandbox mode включён. Поля те же, что и для рабочих учётных записей: HUF account — Merchant ID, HUF account — Secret key и такие же пары для EUR и USD. Значения возьмите из кабинета мерчанта тестовой среды SimplePay (sandbox.simplepay.hu), учётная запись > Технические данные.

IPN URL

IPN — это сообщение, которое SimplePay отправляет в ваш магазин при изменении статуса платежа. Это обычный способ, которым заказ становится оплаченным. На странице настроек показан IPN URL вашего магазина. Он выглядит так: https://your-site/wc-api/simplepay_payment_callback/. Укажите этот URL для каждой учётной записи мерчанта, рабочей и тестовой, в кабинете SimplePay. Если ваш сайт использует языковой префикс в URL или перенаправляет другие адреса, скопируйте URL в точности так, как он показан в настройках, потому что перенаправленный IPN теряется.

IPN должен быть подписан SECRET KEY той учётной записи мерчанта, которую он называет. IPN без действительной подписи отклоняются. Плагин подтверждает каждый действительный IPN для SimplePay в подписанной форме, которую требует SimplePay. Эти статусы IPN меняют заказ:

Статусы «Не удался» и «Отменён» выставляются только для последней попытки оплаты заказа, который всё ещё в статусе «Ожидает оплаты». Остальные статусы записываются в журнал и не меняют заказ. Без IPN заказ подтверждается только тогда, когда покупатель возвращается в магазин после успешного платежа.

Заказы

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

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

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

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

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

Покупатель выбирает способ оплаты (по умолчанию SimplePay (Card Payment)) и оформляет заказ. Плагин запускает платёж картой SimplePay на сумму заказа в валюте заказа, с учётной записью мерчанта этой валюты в текущем режиме, и отправляет покупателя на платёжную страницу SimplePay. Страница показывает то, что ваша учётная запись мерчанта разрешает для платежей картами. E-mail покупателя и, если он заполнен полностью, платёжный адрес передаются в SimplePay. Платёжная страница использует язык вашего сайта, если SimplePay его поддерживает, иначе английский. Начатый платёж можно оплатить в течение 30 минут.

После успешной оплаты покупатель возвращается на страницу «Заказ получен» вашего магазина. Один лишь возврат заказ не оплачивает: плагин запрашивает у SimplePay статус транзакции подписанным запросом, поэтому заказ подтверждается, даже если IPN пришёл с опозданием. Страница «Заказ получен» показывает Successful transaction. SimplePay transaction ID: и ID. Если платёж ещё не подтверждён, она показывает Your payment is being confirmed by SimplePay. SimplePay transaction ID: и ID.

Если платёж не прошёл, отменён или истёк, покупатель возвращается на оформление заказа или, если корзина пуста, на страницу Pay for order. Там он видит сообщение SimplePay с ID транзакции, например Cancelled payment. You cancelled the payment или Timeout. The time allowed to complete the payment has expired. При неудачном платеже покупателю предлагается проверить введённые данные и связаться с банком, выпустившим карту. Покупатель может попробовать снова. Каждая новая попытка получает собственный референс SimplePay, например 123, 123-2, 123-3.

Если SimplePay не может начать платёж, покупатель видит The SimplePay payment could not be started. Please try again or choose another payment method. Если для валюты заказа нет учётной записи мерчанта, сообщение будет SimplePay is not available for the currency of this order. Please choose another payment method. Техническая причина добавляется в примечания к заказу и в журнал. Менеджеры магазина, вошедшие в систему, видят её и в сообщении.

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

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

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

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

Pending payment: покупатель отправлен в SimplePay и ещё не заплатил, либо SimplePay ещё не подтвердил платёж. Примечание к заказу показывает начатую транзакцию, сумму и режим (тестовый или рабочий).

Processing or Completed: платёж подтверждён. Статус соответствует Order Status After Payment. Примечание к заказу показывает ID транзакции и то, подтвердил ли платёж IPN или запрос статуса. ID транзакции SimplePay сохраняется как ID транзакции заказа. Поздний успешный платёж также завершает заказ, который был в статусе «Не удался» или «Отменён».

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

Failed: SimplePay сообщил, что последняя попытка платежа не авторизована или является мошеннической.

Cancelled: SimplePay сообщил, что последняя попытка платежа истекла по времени или была отменена.

Заказ, по которому оформлен возврат, или выполненный заказ никогда не открывается заново поздним IPN. Если для уже оплаченного заказа проходит второй платёж, заказ не меняется. Примечание просит вас проверить платёж в кабинете SimplePay и вернуть его, если это дубликат.

Возвраты

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

Возвраты, сделанные в кабинете мерчанта SimplePay, не синхронизируются с WooCommerce. Зарегистрируйте их в WooCommerce вручную, без использования Refund via SimplePay (OTP).

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

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

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

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

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

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

SimplePay не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включён, валюта заказа — HUF, EUR или USD, и для этой валюты в текущем режиме заполнены и Merchant ID, и Secret key: тестовые учётные записи, пока включён Sandbox mode, рабочие — пока он выключен. Страница настроек показывает предупреждение, если для валюты магазина нет учётной записи.

Платёж прошёл, но заказ остаётся в статусе Pending payment: IPN не дошёл до магазина. В кабинете мерчанта SimplePay проверьте IPN URL используемой учётной записи (рабочей или тестовой, валюта заказа). Он должен точно совпадать с URL из настроек, а ваш сервер должен быть доступен из интернета. Заказ также подтверждается, когда покупатель возвращается в магазин после оплаты.

IPN отвечает Invalid signature: IPN называет учётную запись мерчанта, которой нет в настройках, или её Secret key неверен. Введите MERCHANT и SECRET KEY точно так, как их показывает кабинет мерчанта SimplePay. SimplePay повторяет неподтверждённые IPN.

IPN отвечает Order not found или Unknown transaction: IPN относится к заказу или транзакции, которые этот магазин не запускал. Заказ не меняется.

IPN отвечает Busy, retry: заказ в тот же момент подтверждался другим запросом. SimplePay повторит IPN.

Покупатель видит ошибку при оформлении заказа: откройте примечания к заказу или посмотрите WooCommerce > Status > Logs, источник wcp_simplepay_gateway. Неверный secret key даёт Invalid response signature from SimplePay. Check the secret key of the merchant account. Ошибки SimplePay показываются как SimplePay error code(s): и затем коды.

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

Заказ переходит в статус On hold после оплаты: прочитайте примечание к заказу. Сумма или валюта заказа были изменены после запуска платежа. Выполните заказ или сделайте возврат платежа.

Возврат не проходит: прочитайте сообщение. SimplePay refunds in HUF must be whole amounts. означает, что сумма в HUF содержала десятичные знаки. Если сообщение говорит, что учётная запись мерчанта для этого платежа не настроена, введите заново учётную запись (валюту и режим), в которых был совершён платёж. Если SimplePay вернул другую сумму, сообщение просит проверить возврат в кабинете SimplePay.

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

Удаление

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

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