VibeFox MakeCommerce for WooCommerce — Помощь

Требования

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

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

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

Доступ к сайту из интернета: MakeCommerce отправляет уведомления о платежах в ваш магазин, поэтому сайт должен быть доступен из интернета (рекомендуется HTTPS). Брандмауэр, режим обслуживания или базовая аутентификация могут их блокировать.

Учётная запись MakeCommerce: вам потребуются Shop ID и Secret key из Merchant Portal MakeCommerce (Settings > API). Тестовая и рабочая среды имеют отдельные учётные записи и ключи. Доступные способы оплаты и валюты определяются вашим договором с MakeCommerce (банковские ссылки работают в EUR). Валюты с тремя десятичными знаками, такие как KWD или BHD, не поддерживаются.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите Shop ID и Secret key для тестовой среды, а для реальных платежей — ключи рабочей среды (см. Настройка). В Merchant Portal ничего настраивать не требуется.

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

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > MakeCommerce. Над полями страница отображает Test mode is on: payments are created in the MakeCommerce test environment and no real money is charged. пока включён тестовый режим. Она предупреждает вас, если способ включён, но Shop ID или Secret key для текущей среды не указаны, а также если валюта магазина не может быть принята через MakeCommerce. В обоих случаях способ оплаты скрывается при оформлении заказа. В списке способов оплаты MakeCommerce помечается как требующий настройки, пока для текущей среды не будут заданы ключи. Пробелы удаляются из ключей при сохранении.

General

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

Title: название способа оплаты, которое покупатели видят при оформлении заказа. По умолчанию: Bank link or card (MakeCommerce).

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay with your Estonian, Latvian, Lithuanian or Finnish bank, or by card. You will be redirected to the secure MakeCommerce payment page.

MakeCommerce account

Shop ID и Secret key находятся в Merchant Portal MakeCommerce в разделе Settings > API. Тестовый и рабочий порталы имеют отдельные учётные записи и ключи. В разделе приведены ссылки на оба портала и на страницу регистрации MakeCommerce.

Test mode: Use the MakeCommerce test environment (no real money is charged). Новые платежи создаются в выбранной среде с соответствующими ключами. Каждый заказ запоминает среду, в которой он был оплачен: проверки статуса и возвраты всегда направляются туда. При оформлении заказа отображается строка TEST MODE — MakeCommerce test environment, no real money is charged. По умолчанию: включено.

Test Shop ID: Shop ID вашей тестовой учётной записи в формате xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.

Test Secret key: Secret key вашей тестовой учётной записи.

Live Shop ID: Shop ID вашей рабочей учётной записи.

Live Secret key: Secret key вашей рабочей учётной записи.

Payment notifications

В Merchant Portal ничего настраивать не требуется. Каждая транзакция несёт собственные URL-адреса возврата, отмены и уведомления на основе адреса, указанного в этом разделе (выглядит как https://your-site/wc-api/wc_mkc_payment/), с добавлением номера и ключа заказа. MakeCommerce отправляет подписанное сообщение на URL уведомления (между серверами) и через браузер покупателя на URL возврата или отмены. Подпись проверяется с помощью Secret key той среды, в которой была создана транзакция. Сообщения без корректной подписи отклоняются.

Плагин обрабатывает следующие статусы транзакций MakeCommerce:

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

Advanced

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

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

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

Покупатель выбирает способ оплаты (по умолчанию Bank link or card (MakeCommerce)) и оформляет заказ. Плагин создаёт транзакцию MakeCommerce на общую сумму заказа в валюте заказа и направляет покупателя на страницу оплаты MakeCommerce. Там покупатель выбирает банковскую ссылку или карту. Электронная почта и страна плательщика передаются в MakeCommerce, и страница открывается на языке магазина, если MakeCommerce его поддерживает (эстонский, английский, латышский, литовский, финский, русский, немецкий, польский), иначе на английском языке.

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

Если покупатель отменяет оплату на странице MakeCommerce или срок действия платежа истекает, покупатель возвращается к оформлению заказа (или на страницу Pay for order) с сообщением, например The payment was cancelled. You can try again or choose another payment method. или The payment session expired. Please try again. Если платёж пока не удаётся подтвердить, отображается сообщение We could not confirm your payment yet. If you completed it, your order will be updated automatically; otherwise please try again. Покупатель может повторить оплату. Более ранняя платёжная ссылка для того же заказа продолжает действовать, при этом заказ невозможно оплатить дважды.

Если MakeCommerce не может начать платёж, покупатель видит сообщение MakeCommerce is temporarily unavailable. Please try again in a moment or choose another payment method. или MakeCommerce could not start the payment for this order. Please choose another payment method or contact us. Техническая причина добавляется в примечания к заказу и в журнал.

Способ оплаты работает на классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с высокопроизводительным хранилищем заказов WooCommerce (HPOS).

Банк или карта выбираются на странице MakeCommerce, а не на вашей странице оформления заказа. В плагине нет сохранённых карт, регулярных платежей и WooCommerce Subscriptions, а также доставки MakeCommerce (почтоматов, этикеток).

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

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

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

Processing: платёж подтверждён. Заказы, содержащие только виртуальные загружаемые товары, переходят в статус Выполнен (стандартное поведение WooCommerce). В примечании к заказу отображаются сумма, транзакция, среда и способ подтверждения (API MakeCommerce или подписанное уведомление). Номер транзакции соответствует ID транзакции MakeCommerce.

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

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

Если поступит повторный платёж по уже оплаченному заказу, заказ повторно не изменяется. Примечание предложит вам вернуть дубликат через Merchant Portal MakeCommerce.

Check MakeCommerce payment status

На экране заказа выберите действие Check MakeCommerce payment status в списке действий с заказом. Плагин запрашивает через API MakeCommerce статус транзакций заказа (начиная с самой последней), применяет его и добавляет примечание с результатом. Используйте это действие, если заказ остаётся в статусе Ожидание оплаты, хотя покупатель уже заплатил.

Возвраты

Откройте заказ, нажмите Refund, введите сумму и нажмите Refund via Bank link or card (MakeCommerce) (на кнопке отображается ваш Title). Поддерживаются полные и частичные возвраты. Возврат отправляется в ту среду, в которой был оплачен заказ (тестовую или рабочую), поэтому ключи для этой среды должны быть настроены. Если MakeCommerce отклоняет возврат, WooCommerce отображает ошибку, добавляется примечание к заказу и возврат не фиксируется. Если MakeCommerce всё ещё обрабатывает платёж, отображается сообщение MakeCommerce is still processing this payment — try the refund again later. Успешный возврат добавляется в примечания к заказу с идентификатором возврата MakeCommerce.

Возвраты, оформленные через Merchant Portal, поступают со статусом транзакции и добавляются в примечания к заказу. Они не регистрируются автоматически в качестве возвратов WooCommerce.

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

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

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

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

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

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

MakeCommerce не отображается при оформлении заказа: убедитесь, что лицензия активна, опция Enable/Disable включена, а для текущей среды заданы ключи: Test Shop ID и Test Secret key в тестовом режиме, Live Shop ID и Live Secret key в рабочем режиме. Убедитесь, что валюта магазина (или валюта заказа на странице Pay for order) имеет не более двух десятичных знаков. Страница настроек выводит предупреждение для каждой из этих проблем.

Платёж прошёл, но заказ остаётся в статусе Ожидание оплаты: уведомления не смогли дойти до сайта, например из-за брандмауэра, режима обслуживания или базовой аутентификации. Откройте заказ и выполните действие Check MakeCommerce payment status. Убедитесь, что ключи среды, в которой производился платёж, заданы: уведомление проверяется с помощью Secret key этой среды, и без него MakeCommerce получает ошибку и повторяет попытки.

Заказ находится На удержании с примечанием от MakeCommerce: платёж не соответствовал заказу (сумма, валюта, статус) либо поступил по отменённому заказу. Проверьте транзакцию в Merchant Portal и завершите либо верните заказ вручную.

Уведомления отклоняются: сообщение с неверной подписью, относящееся к другому заказу, другому магазину или транзакции, не связанной с данным заказом, отклоняется, и заказ не изменяется. Убедитесь, что Shop ID и Secret key относятся к одной и той же учётной записи и среде MakeCommerce.

Покупатель видит ошибку при оформлении заказа: откройте примечания к заказу или включите Debug log и просмотрите WooCommerce > Status > Logs, источник wcp_makecommerce_payment. Валюта, которую MakeCommerce не может обработать, возвращает сообщение MakeCommerce cannot process payments in и код валюты.

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

Сбой возврата с сообщением No MakeCommerce transaction ID found for this order: у заказа нет транзакции MakeCommerce. Оформите возврат через Merchant Portal.

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

Удаление

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

MakeCommerce является товарным знаком соответствующего владельца. Этот плагин не связан с MakeCommerce и не одобрен ею.