VibeFox Comgate for WooCommerce — Помощь

Требования

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

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

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

HTTPS: ваш сайт должен быть доступен из интернета по HTTPS, чтобы Comgate мог доставить фоновое уведомление.

Валюта: CZK, EUR, PLN, HUF, USD, GBP, RON, HRK, NOK или SEK. Для других валют, а также для сумм ниже минимума Comgate способ оплаты скрыт. Платежи в HUF округляются до целых форинтов, как того требует Comgate.

Учётная запись Comgate: нужны Merchant ID и Secret (пароль для фонового обмена данными) подключения вашего магазина в клиентском портале Comgate, а также URL уведомлений, указанный там (см. раздел «Настройка»). Comgate использует одни и те же Merchant ID и Secret для тестовых и рабочих платежей.

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

Установка

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

2. Нажмите Activate.

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

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

5. Введите Merchant ID и Secret из клиентского портала Comgate и укажите там URL уведомлений (см. раздел «Настройка»).

6. Включите Enable / Disable. Оставьте Test Mode включённым для пробного платежа, затем выключите его.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Comgate. Над полями страница предупреждает, если Comgate включён, но не заполнены Merchant ID или Secret (тогда способ оплаты скрыт при оформлении заказа, пока оба поля не заполнены), а также если валюта магазина не поддерживается. Пока включён тестовый режим, страница показывает Test mode is on: payments are created as Comgate test payments and no money is charged. Turn it off before going live.

Общие

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

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

Description: текст под способом оплаты при оформлении заказа. По умолчанию: Pay securely via Comgate — cards, bank transfers, wallets and more. В тестовом режиме к нему добавляется TEST MODE: no real money is charged., либо это сообщение показывается отдельно, если описание пустое.

Подключение Comgate

Возьмите идентификатор магазина (Merchant ID) и пароль (Secret) в клиентском портале Comgate: Integration > shop connection settings. Там же укажите URL for passing the payment result (фоновое уведомление) — адрес, который показан в этом разделе. Он выглядит так: https://your-site/wc-api/comgate_payment_callback/. Comgate вызывает его после каждого платежа; затем плагин перепроверяет платёж через API статуса Comgate, прежде чем изменить заказ. Адреса возврата покупателя передаются с каждым платежом. Если портал также запрашивает адреса возврата (оплачено, отменено, в ожидании), используйте второй адрес из этого раздела, который выглядит так: https://your-site/wc-api/comgate_payment_return/?id=${id}&refId=${refId}.

Merchant ID: идентификатор интернет-магазина в Comgate (merchant).

Secret: пароль для фонового обмена данными (secret) этого подключения магазина.

Test Mode: Create test payments (no money is charged). Comgate использует одни и те же Merchant ID и Secret для тестовых и рабочих платежей; тестовые платежи помечаются как test=true. Возвраты всегда отправляются в том режиме, в котором был проведён исходный платёж. По умолчанию: включено.

Платёжная страница

Payment Methods: способы оплаты Comgate, из которых может выбирать покупатель. Показываются только способы, включённые для вашего магазина в Comgate.

Language: язык платёжной страницы Comgate. Automatic (site language, English as fallback) (по умолчанию) или один из 26 языков.

Заказы

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

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

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

Delete Data on Uninstall: Remove the gateway settings and log files when the plugin is deleted. Заказы и их ID транзакций Comgate всегда сохраняются. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Comgate) и оформляет заказ. Плагин создаёт платёж в Comgate на сумму заказа в валюте заказа и перенаправляет покупателя на платёжную страницу Comgate. Адрес e-mail и имя из платёжных данных передаются в Comgate, а платёж помечается номером заказа. Действительный адрес e-mail для платёжных данных обязателен. На странице Comgate покупатель платит одним из разрешённых вами способов.

После оплаты покупатель возвращается в ваш магазин. Заказ отмечается оплаченным только после подтверждения Comgate: плагин читает платёж через API статуса Comgate, и когда приходит фоновое уведомление, и когда покупатель возвращается. Если платёж ещё не подтверждён, например банковский перевод в пути, на странице «Заказ получен» показывается Comgate has not confirmed your payment yet. The order will be updated automatically as soon as the payment is confirmed — please do not pay again. Если заказ переведён на удержание, страница показывает Your payment is being reviewed. We will contact you if anything else is needed.

Если платёж отменён или истёк, покупатель возвращается к оформлению заказа (или в корзину) с сообщением The Comgate payment was cancelled or has expired. You can try again or choose another payment method. Неоплаченный заказ покупатель может оплатить снова, например со страницы Pay for order. Предыдущая попытка проверяется первой, поэтому уже прошедший платёж не списывается дважды, а если она ещё открыта, отменяется в Comgate. Запоздалый платёж по более ранней попытке по-прежнему оплачивает неоплаченный заказ.

Если Comgate не может начать платёж, покупатель видит короткое сообщение, например The Comgate payment could not be started. Please try again or choose another payment method., что Comgate не принимает эту сумму или валюту, либо что выбранный способ оплаты Comgate недоступен. Техническая причина записывается в журнал.

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

Плагин принимает разовые платежи только на странице Comgate. В нём нет регулярных платежей, подписок и сохранённых карт, нет встроенной формы Comgate и кнопок Apple Pay и Google Pay на вашем сайте (они доступны на странице Comgate), а также нет списания или отмены предварительных авторизаций из WooCommerce. Без уведомления статус платежа автоматически не запрашивается; он проверяется только при возврате покупателя.

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

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

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

Processing или Completed: Comgate сообщил о платеже со статусом PAID с той же суммой и валютой. Статус соответствует настройке Order Status After Payment. ID транзакции заказа — это ID транзакции Comgate; все попытки хранятся вместе с заказом. Тестовые платежи получают примечание Comgate test payment — no money was charged.

On hold: оплаченная сумма или валюта отличаются от заказа, тестовый платёж подтверждён в рабочем режиме магазина (деньги не получены), либо платёж только авторизован (предварительная авторизация в вашей учётной записи Comgate). Авторизованный платёж становится оплаченным автоматически, когда вы его списываете в портале Comgate. В примечании к заказу указана причина.

Cancelled: текущий платёж Comgate отменён или истёк. Если Comgate подтверждает платёж после того, как WooCommerce отменил неоплаченный заказ (например, медленный банковский перевод), заказ снова переводится в оплаченные с примечанием проверить остатки перед отправкой.

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

Возвраты

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

Возвраты, сделанные в портале Comgate, в магазин не передаются. При необходимости создайте ручной возврат в WooCommerce, не используя Refund via платёжного шлюза.

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

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

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

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

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

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

Comgate не появляется при оформлении заказа: проверьте, что лицензия активна, Enable / Disable включено, заполнены Merchant ID и Secret, валюта заказа поддерживается и сумма заказа не ниже минимума Comgate (например, 1 CZK, 0,10 EUR или 100 HUF). Страница настроек показывает предупреждение, если учётные данные не заполнены или валюта не поддерживается.

Оплата прошла, но заказ остаётся в статусе Ожидание оплаты: Comgate не доставил фоновое уведомление. Проверьте URL for passing the payment result в портале Comgate, доступность вашего сайта из интернета по HTTPS (без режима обслуживания и защиты паролем) и журнал (включите Debug Log). Comgate повторяет недоставленные уведомления; плагин отвечает ошибкой каждый раз, когда не смог обработать уведомление, поэтому оно будет отправлено повторно. Заказ также подтверждается, когда покупатель возвращается в магазин.

Уведомление отвечает Invalid merchant or secret: Merchant ID или Secret в настройках не совпадают с подключением магазина в портале Comgate.

Уведомление отвечает Gateway not configured: Merchant ID или Secret в настройках пусты. Comgate повторит уведомление, когда поля будут заполнены.

Уведомление отвечает Order not found, Unknown transaction или Reference mismatch: уведомление относится к платежу, который не был создан этим магазином для этого заказа. Заказ не изменяется.

Уведомление отвечает Status verification failed, Status verification rejected или Busy, retry later: API статуса Comgate не ответил, отклонил запрос, либо заказ в этот момент обрабатывал другой запрос. Comgate повторит уведомление.

Покупатель видит We could not verify the Comgate payment: ссылка возврата не совпала с заказом. Если деньги были списаны, уведомление всё равно подтвердит заказ. Проверьте платёж в портале Comgate, прежде чем покупатель заплатит снова.

Покупатель видит The order total is below the minimum amount accepted by Comgate или A valid billing e-mail address is required for Comgate payments: заказ в таком виде не может быть оплачен через Comgate.

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

Возврат не проходит: прочитайте сообщение. Comgate rejected the refund: the amount exceeds the refundable amount. означает, что сумма больше остатка к возврату; платёж в статусе, отличном от PAID, вернуть нельзя. Comgate could not be reached. The refund was not made — please try again later. означает проблему соединения.

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

Удаление

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

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