VibeFox ifthenpay for WooCommerce — Помощь

Требования

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

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

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

Валюта: только евро (EUR). Способ оплаты скрывается, если валюта магазина или заказа не EUR. ifthenpay принимает суммы от 0,01 до 99 999,99 EUR.

Аккаунт ifthenpay: зарегистрируйтесь на ifthenpay.com. Нужен ключ способа, который вы предлагаете: Multibanco, MB WAY или Credit Card (формат ABC-123456). Ключи показаны в бэк-офисе ifthenpay (backoffice.ifthenpay.com) или присылаются ifthenpay, когда способ активируется для вашего аккаунта. ifthenpay также должен активировать callback для вашего ключа (см. раздел «Настройка»), а ваш магазин должен быть доступен из интернета.

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

Установка

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

2. Нажмите Activate. Плагин создаст свой антифишинговый ключ.

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

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

5. Выберите Payment Method и введите его ключ ifthenpay. Сохраните настройки, чтобы Callback URL соответствовал выбранному способу.

6. Скопируйте Anti-phishing Key и Callback URL, показанные в настройках, и попросите ifthenpay активировать callback для вашего ключа (в бэк-офисе или через службу поддержки ifthenpay).

7. Включите Enable/Disable.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > ifthenpay. Без ключа выбранного способа он не показывается на оформлении заказа, а в списке способов оплаты помечается как требующий действий. При сохранении включённого шлюза без этого ключа страница показывает ifthenpay: enter the key of the selected payment method, otherwise the method is not shown at checkout.

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

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

Description: описание способа оплаты, которое показывается на оформлении заказа. По умолчанию: Pay via Multibanco, MB WAY or Credit Card. Измените его, чтобы оно соответствовало предлагаемому способу.

Payment Method: способ, который предлагается на оформлении заказа. Нужен только ключ этого способа.

Ключи ifthenpay

Ключи (формат ABC-123456) показаны в бэк-офисе ifthenpay или присылаются ifthenpay, когда способ оплаты активируется для вашего аккаунта.

Multibanco Key: ваш ключ ifthenpay Multibanco (MB) для динамических референсов.

MB WAY Key: ваш ключ ifthenpay MB WAY.

Credit Card Key: ваш ключ ifthenpay Credit Card. Он также проверяет подпись возврата покупателя со страницы карты.

Callback (уведомления об оплате)

Callback сообщает вашему магазину, что оплата произведена. Попросите ifthenpay активировать callback для каждого используемого ключа, с антифишинговым ключом и URL callback, указанными ниже. Заказы Multibanco и MB WAY подтверждаются только callback; платежи картой подтверждаются также подписанным возвратом со страницы карты.

Anti-phishing Key: создаётся плагином, показывается для копирования. ifthenpay возвращает его в каждом callback; callback без него отклоняются.

Callback URL: URL callback для выбранного способа оплаты с плейсхолдерами ifthenpay, показывается для копирования. Он начинается с https://your-site/wc-api/ifthenpay_payment_callback/ и продолжается параметрами способа. Скопируйте весь URL точно так, как он показан в настройках.

Антифишинговый ключ в каждом callback сравнивается с вашим. Отсутствующий или неверный ключ получает ответ 403, и заказ не меняется. Callback также должен соответствовать заказу этого шлюза: для Multibanco — по организации и референсу, для MB WAY — по заказу и одному из его запросов MB WAY, для Credit Card — по заказу и его запросу карты. Без рабочего callback заказы Multibanco и MB WAY никогда не подтверждаются, а платежи картой подтверждаются только подписанным возвратом.

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

Test Mode: Enable test/sandbox mode. Для Credit Card и Multibanco используется песочница ifthenpay: реальные деньги не списываются, вы используете тестовые ключи от ifthenpay. У MB WAY нет песочницы: проверяйте его тестовым ключом от ifthenpay. На оформлении заказа показывается значок TEST MODE. По умолчанию: выключено.

Order Status After Payment: статус заказа после подтверждённой оплаты, с одним изменением статуса и одним письмом покупателю. Заказы, которые содержат только виртуальные загружаемые товары, всегда завершает WooCommerce.

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

Delete Data on Uninstall: Remove the plugin settings, the anti-phishing key and the logs when the plugin is deleted (orders are kept). По умолчанию: выключено.

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

Multibanco. На оформлении заказа покупатель видит You will receive a Multibanco reference to complete the payment. При оформлении заказа плагин создаёт динамический референс Multibanco на сумму заказа. Заказ переходит в статус «На удержании», остаток товара уменьшается, корзина очищается. На странице «Заказ получен» и в письмах о заказе, отправленных пока заказ на удержании, показаны Multibanco Payment Details: организация, референс и сумма, а также Please use these details to pay at any Multibanco ATM or through your online banking. Если покупатель снова оформит заказ на ту же сумму, используется тот же референс. Заказ подтверждается, когда ifthenpay отправит callback об оплате.

MB WAY. Покупатель вводит MB WAY phone number (912 345 678, +351 912 345 678 или 351#912345678 для других стран); телефон для выставления счёта заполняется. Плагин отправляет запрос на оплату на телефон, заказ переходит в статус «На удержании», остаток уменьшается, корзина очищается. На странице «Заказ получен» написано A payment request has been sent to your phone via MB WAY. Please confirm it in the MB WAY app. Все запросы заказа сохраняются, поэтому ранее подтверждённый в приложении запрос по-прежнему принимается. Заказ подтверждается callback.

Банковская карта. Покупатель видит You will be redirected to a secure page to enter your card details. и переходит на страницу карт ifthenpay. Заказ остаётся в статусе «Ожидает оплаты», пока не оплачен, и остаток до этого не уменьшается. После успешной оплаты покупатель возвращается в ваш магазин. Возврат принимается только при действительной подписи ifthenpay, ключе заказа, секрете этой попытки и запросе карты заказа; тогда заказ отмечается оплаченным. Если возврат не удаётся проверить, заказ не меняется, а на странице «Заказ получен» показано Your card payment is being confirmed by ifthenpay. You will receive an e-mail as soon as it is confirmed. Неудачный платёж картой переводит заказ в статус «Неудачный», а отменённый оставляет его в статусе «Ожидает оплаты». В обоих случаях покупатель попадает на страницу Pay for order с сообщением The card payment was not completed. You can try again or choose another payment method. или The card payment was cancelled. You can try again or choose another payment method.

Заказ отмечается оплаченным только после подтверждения оплаты ifthenpay, а сумма проверяется до цента по сумме заказа. Если оплату не удаётся начать, покупатель видит короткое сообщение, например The Multibanco reference could not be created. Please try again or choose another payment method., The MB WAY payment request could not be sent. Please check that the phone number is linked to MB WAY, or choose another payment method. или The payment service is temporarily unavailable. Please try again in a few minutes.

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

Плагин предлагает один способ ifthenpay за раз. Он не поддерживает Payshop, Cofidis Pay, Apple Pay, Google Pay, PIX или Pay-by-Link, подписки и сохранённые карты, автоматическое истечение или отмену неоплаченных референсов Multibanco и опрос статуса платежа.

Заказы

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

On hold (waiting for payment): выдан референс Multibanco или отправлен запрос MB WAY. Неоплаченные референсы не отменяются автоматически; при необходимости отмените такие заказы сами.

Pending payment: начат платёж картой, который ещё не подтверждён, или он отменён.

Processing or Completed: оплата подтверждена. Статус соответствует Order Status After Payment. В примечании к заказу показаны организация и референс Multibanco, транзакция MB WAY или ID запроса карты.

On hold after payment: полученная сумма отличалась от суммы заказа, или оплата поступила после отмены заказа. Примечание к заказу объясняет причину. Проверьте платёж в бэк-офисе ifthenpay и вручную завершите или возвратите заказ.

Failed: покупатель вернулся со страницы карты с ошибкой.

Повторное уведомление об оплате для уже оплаченного заказа только добавляет примечание, чтобы вы проверили дубликат платежа в бэк-офисе ifthenpay. Возвращённые заказы и заказы, отменённые после оплаты, никогда не открываются снова.

Возвраты

Возвраты из WooCommerce не поддерживаются. Верните платёж в бэк-офисе ifthenpay и отметьте его в WooCommerce вручную. Callback о возврате (DEVOLVIDO) только добавляет примечание к заказу. Другие статусы, которые сообщает ifthenpay, тоже только добавляют примечание.

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

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

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

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

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

Решение проблем

ifthenpay не появляется на оформлении заказа: проверьте, что лицензия активна, Enable/Disable включён, заполнен ключ выбранного Payment Method, валюта EUR и сумма от 0,01 до 99 999,99 EUR. На странице Pay for order учитывается валюта заказа.

Покупатель оплатил, но заказ остаётся On hold или Pending payment: callback не доходит до вашего магазина. Проверьте, что ifthenpay активировал URL callback и антифишинговый ключ для используемого ключа и что URL соответствует выбранному способу. Сайт должен быть доступен из интернета, а не на localhost и не за логином. Ищите строки Callback rejected в WooCommerce > Status > Logs, источник wcp_ifthenpay_gateway.

Callback отвечает 403 Forbidden: антифишингового ключа в callback нет или он отличается от ключа в настройках. Отправьте ifthenpay ключ, показанный в настройках, ещё раз.

Callback отвечает 503 Not configured: антифишинговый ключ ещё не создан. Откройте страницу настроек один раз; ifthenpay повторит callback.

Callback отвечает Order not found: референс или запрос не принадлежит заказу этого шлюза, например потому что способ оплаты был изменён после оформления заказа.

Почему оплаченный заказ перевели в On hold? Полученная сумма отличалась от суммы заказа, или оплата поступила после отмены заказа. Прочитайте примечание к заказу, проверьте платёж в бэк-офисе ifthenpay и вручную завершите или возвратите заказ.

Не удалось отправить запрос MB WAY: номер телефона не привязан к MB WAY или записан в неверном формате. Используйте 912 345 678 или 351#912345678 для номеров других стран.

Тестовый режим и MB WAY: у ifthenpay нет песочницы для MB WAY; используйте тестовый ключ, предоставленный ifthenpay.

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

Удаление

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

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