VibeFox MultiSafepay for WooCommerce — Помощь

Требования

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

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

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

Валюта: валюта магазина или заказа должна быть одной из тех, которые принимает MultiSafepay, например EUR, USD, GBP, PLN, CHF, SEK, DKK или NOK. Для других валют способ оплаты скрывается при оформлении заказа.

Аккаунт MultiSafepay: нужен API-ключ вашего сайта в MultiSafepay Control. Тестовый и рабочий аккаунты имеют разные ключи. Больше ничего настраивать в MultiSafepay не нужно: адрес уведомлений передаётся с каждым платежом.

Публичный сайт: MultiSafepay должен иметь доступ к вашему сайту, чтобы отправлять уведомления. В противном случае заказы всё равно обновятся, когда покупатель вернётся из MultiSafepay.

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

Установка

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

2. Нажмите Activate.

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

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

5. Вставьте тестовый и/или рабочий API-ключ из MultiSafepay Control (см. раздел «Настройка»).

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

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > MultiSafepay. В заголовке страницы отображается метка Test mode, пока включён тестовый режим. Над полями страница предупреждает, если для текущего режима не задан API-ключ (тогда способ оплаты не показывается при оформлении заказа) или MultiSafepay не принимает валюту магазина. В списке способов оплаты MultiSafepay помечен как требующий настройки, пока для текущего режима не задан API-ключ.

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

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

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

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely with iDEAL, cards, Bancontact, PayPal and more via MultiSafepay.

API-ключи

API-ключ можно найти в MultiSafepay Control > Manage settings > Website settings. Тестовый аккаунт (testmerchant.multisafepay.com) и рабочий аккаунт (merchant.multisafepay.com) имеют разные ключи. Тестовый режим использует только тестовый ключ, рабочий режим — только рабочий ключ.

Test mode: Use the MultiSafepay test environment (no real payments). Переключает и адрес API, и API-ключ. Уже совершённые платежи для проверок статуса и возвратов продолжают использовать ту среду, в которой были сделаны. По умолчанию: включено.

Test API key: API-ключ вашего тестового аккаунта MultiSafepay.

Live API key: API-ключ вашего рабочего аккаунта MultiSafepay.

Уведомления

Ничего настраивать не нужно. В этом разделе показан адрес уведомлений, который передаётся в MultiSafepay с каждым платежом. Он выглядит примерно так: https://your-site/?wc-api=mspg_webhook. MultiSafepay должен иметь доступ к вашему сайту. Уведомление лишь сообщает плагину, какой платёж изменился: статус, сумма и валюта всегда читаются через API MultiSafepay с вашим API-ключом до того, как заказ будет изменён. Уведомления о платежах, которые не относятся к заказам вашего магазина, игнорируются.

Заказы

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

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

Debug log: Log API calls and notifications записывает подробности в WooCommerce > Status > Logs, источник wcp_multisafepay_gateway. Ошибки записываются всегда. API-ключи и данные покупателей не записываются. По умолчанию: выключено.

Delete data on uninstall: Remove settings, logs and MultiSafepay order data when the plugin is deleted. Деактивация плагина ничего не удаляет. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию MultiSafepay) и оформляет заказ. Плагин создаёт платёж MultiSafepay на сумму заказа в валюте заказа и отправляет покупателя на платёжную страницу MultiSafepay. Там покупатель выбирает любой способ оплаты, включённый в вашем аккаунте MultiSafepay, и оплачивает. Платёжные данные покупателя и язык магазина передаются в MultiSafepay, а платёж отображается как Order #, номер заказа и название вашего сайта. В тестовом режиме при оформлении заказа отображается Test mode: no real payment will be made.

Остаток товара резервируется, пока покупатель платит, а корзина сохраняется до страницы «Заказ получен». После оплаты покупатель возвращается на страницу «Заказ получен» вашего магазина. Заказ отмечается оплаченным только после подтверждения MultiSafepay: через уведомление или через проверку API MultiSafepay, когда покупатель попадает на эту страницу.

Если покупатель отменяет оплату на странице MultiSafepay во время оформления, заказ отменяется стандартным для WooCommerce способом, остатки освобождаются, а товары остаются в корзине. Если покупатель оплачивал со страницы Pay for order, он возвращается на эту страницу, где объясняется, что произошло: The MultiSafepay payment was cancelled. You can try again or choose another payment method., The payment was declined. Please try again or choose another payment method. или The payment session has expired. Please try again.

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

Если MultiSafepay не может начать платёж, покупатель видит короткое сообщение, например Could not connect to MultiSafepay. Please try again in a moment. или MultiSafepay cannot accept this order amount or currency. Please choose another payment method., и может выбрать другой способ оплаты. Ошибка MultiSafepay добавляется в примечания к заказу.

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

Плагин предлагает один способ оплаты, который ведёт на страницу MultiSafepay. В WooCommerce нет отдельных способов оплаты для каждого способа MultiSafepay, нет встроенных полей карты, кнопок экспресс-оплаты Apple Pay или Google Pay, подписок, регулярных платежей или сохранённых карт, а также нельзя выполнить списание или отмену из WooCommerce. Данные корзины не передаются, поэтому MultiSafepay не предлагает для таких заказов способы отложенной оплаты, которым они нужны (например, Klarna, in3 или Riverty).

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

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

Pending payment: покупатель отправлен в MultiSafepay и ещё не оплатил.

Processing или Completed: MultiSafepay подтвердил платёж (завершён или отправлен). Статус соответствует Order status after payment. В примечании к заказу указаны ID платежа MultiSafepay, способ оплаты и среда. ID транзакции — это ID заказа MultiSafepay для платежа.

On hold before payment: платёж не завершён (его проверяет MultiSafepay) или зарезервирован (авторизован). Чтобы получить деньги, выполните списание зарезервированного платежа в MultiSafepay Control. Заказ завершается автоматически, когда MultiSafepay сообщает об оплате.

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

On hold after a chargeback: MultiSafepay сообщил о чарджбэке по оплаченному заказу: деньги списаны с вашего счёта.

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

Оплаченный, возвращённый или отменённый заказ никогда не открывается повторно из-за запоздалого уведомления. Если для уже оплаченного заказа завершается второй платёж, заказ не изменяется. Примечание предлагает вам вернуть дубликат в MultiSafepay Control.

Возвраты

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

Возвраты, выполненные в MultiSafepay Control, добавляются в примечания к заказу, когда MultiSafepay сообщает о них. Они не регистрируются автоматически как возвраты WooCommerce. При необходимости создайте ручной возврат в WooCommerce без использования Refund via MultiSafepay.

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

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

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

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

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

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

MultiSafepay не появляется при оформлении заказа: проверьте, что лицензия активна, Enable/Disable включено, для текущего режима задан API-ключ (Test API key в тестовом режиме, Live API key в рабочем режиме), а валюта магазина или заказа принимается MultiSafepay. На странице настроек появляется предупреждение, если ключ отсутствует или валюта не принимается.

Оплата прошла, но заказ остаётся в статусе Pending payment: уведомление не дошло до вашего магазина. Проверьте, что сайт доступен из интернета и что задан API-ключ среды платежа, так как плагин читает статус через API MultiSafepay. Если API недоступен, уведомление отвечает ERROR, и MultiSafepay повторяет его. Заказ также обновляется, когда покупатель возвращается на страницу «Заказ получен» и когда пытается оплатить тот же заказ снова.

Покупатель видит ошибку при оформлении заказа: откройте примечания к заказу или включите Debug log и посмотрите WooCommerce > Status > Logs, источник wcp_multisafepay_gateway. This payment method is temporarily unavailable. Please choose another payment method. обычно означает неверный или отсутствующий API-ключ. MultiSafepay cannot accept this order amount or currency. Please choose another payment method. означает, что MultiSafepay отклонил сумму или валюту.

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

Тестовые платежи не подтверждают рабочий заказ: тестовый платёж никогда не оплачивает заказ, пока магазин работает в рабочем режиме; вместо этого заказ переводится на удержание. Более ранние тестовые платежи по-прежнему проверяются и возвращаются тестовым ключом после перехода в рабочий режим.

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

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

Удаление

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

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