VibeFox Moneris for WooCommerce — Помощь

Требования

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

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

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

Валюта магазина: CAD для канадской учётной записи Moneris, USD для старой учётной записи Moneris USA. Шлюз показывается только тогда, когда валюта заказа совпадает с валютой учётной записи.

HTTPS и PCI DSS: номера карт вводятся на странице оформления заказа и проходят через ваш сервер. Для рабочих платежей нужны HTTPS и соответствие PCI DSS SAQ D. Если вы не можете его обеспечить, используйте решение со страницей оплаты, размещённой у провайдера.

Учётная запись Moneris: вам нужны Store ID и API Token вашего магазина Moneris Gateway из раздела Moneris Merchant Resource Center > Admin > Store Settings. Для тестирования по умолчанию заполнен публичный тестовый магазин Moneris. Тестовые учётные данные и тестовые карты находятся на портале разработчиков Moneris.

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

Установка

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

2. Нажмите Activate.

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

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

5. Выберите страну учётной записи и введите Live Store ID и Live API Token. Тестовый режим включён по умолчанию и использует публичный тестовый магазин (store5 / yesguy для Канады, monusqa002 / qatoken для США).

6. Выберите Purchase или Pre-Authorization и логотипы карт, затем включите Enable / Disable.

7. Оформите тестовый заказ тестовой картой Moneris, затем снимите отметку Test mode.

Настройка

Все настройки находятся на одной странице: WooCommerce > Settings > Payments > Moneris. Над полями страница показывает Moneris gateway is in TEST MODE. No real charges will be made., пока включён тестовый режим. В рабочем режиме она предупреждает, если в рабочих полях указаны тестовые учётные данные Moneris (тогда шлюз скрывается на странице оформления заказа), и если сайт не использует HTTPS. Также она предупреждает, если валюта магазина не совпадает с валютой учётной записи Moneris; тогда шлюз скрывается на странице оформления заказа.

Общие

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

Title: название способа оплаты, которое видит покупатель. По умолчанию: Credit card (Moneris). В тестовом режиме на странице оформления заказа к названию добавляется (Test Mode).

Description: текст, который выводится над полями карты на странице оформления заказа. По умолчанию: Pay securely with your credit card.

Учётная запись Moneris

Store ID и API Token находятся в Moneris Merchant Resource Center в разделе Admin > Store Settings. Тестовые учётные данные и тестовые карты находятся на портале разработчиков Moneris. В этом разделе есть ссылки на оба.

Moneris account country: канадские учётные записи списывают средства в CAD, американские в USD. Шлюз показывается только тогда, когда валюта заказа совпадает. По умолчанию: Canada (CAD).

Canada (CAD): учётная запись Moneris Canada.

United States (USD, legacy Moneris USA accounts): учётная запись Moneris USA.

Test mode: Enable test mode (Moneris QA gateway, test credentials, no real charges). Возвраты, списания и отмены всегда отправляются в ту среду, в которой был произведён платёж. Покупатели видят над полями карты надпись TEST MODE: use a Moneris test card, no real charges are made. По умолчанию: включено.

Live Store ID: Store ID рабочего магазина, например monca01234.

Live API Token: рабочий API Token.

Test Store ID: публичный тестовый магазин Moneris: store5 (Канада) или monusqa002 (США). По умолчанию: store5.

Test API Token: публичный тестовый токен: yesguy (Канада) или qatoken (США). По умолчанию: yesguy.

Оплата

Transaction type: способ списания средств с карты. По умолчанию: Purchase.

Purchase (charge immediately): карта списывается сразу при оформлении заказа.

Pre-Authorization (capture later): средства только резервируются, а заказ переходит в статус «На удержании». Списать их можно, переведя заказ в статус «В обработке» или «Выполнен», либо действием с заказом Capture Moneris pre-authorization. Отмена заказа освобождает средства.

Card logos: логотипы платёжных систем, которые показываются рядом с названием способа оплаты: Visa, Mastercard, Discover, American Express, JCB. Принимаемые карты зависят от вашей учётной записи Moneris. По умолчанию: Visa and Mastercard.

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

Debug log: Log API requests and responses (card number, CVV, expiry and API token are masked). Ошибки всегда записываются в журнал. Журнал находится в разделе WooCommerce > Status > Logs, источник wcp_moneris_gateway. По умолчанию: выключено.

Delete data on uninstall: Remove the gateway settings and logs when the plugin is deleted. По умолчанию: выключено.

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

Покупатель выбирает способ оплаты (по умолчанию Credit card (Moneris)) и вводит номер карты, срок действия и код безопасности в форме карты WooCommerce на странице оформления заказа. При оформлении заказа ваш сервер отправляет карту в Moneris на сумму заказа и сразу получает результат. Перенаправления и webhook нет. Код безопасности (CVD) передаётся всегда, поэтому правила eFraud вашего магазина Moneris по-прежнему действуют.

Одобренный платёж отмечается оплаченным, только когда Moneris сообщает, что транзакция завершена, а обработанная сумма совпадает с суммой заказа. После этого покупатель переходит на страницу подтверждения заказа. При Pre-Authorization заказ остаётся в статусе «На удержании», пока вы не спишете средства.

Если карта отклонена, покупатель видит Your card was declined с причиной от Moneris и может проверить данные карты или использовать другую карту. Если Moneris не смог обработать запрос (например, из-за неверных Store ID или API Token), покупатель видит The payment could not be processed. Please try again or use another payment method. Причина добавляется в примечания к заказу и в журнал. Повторный клик во время обработки платежа показывает A payment for this order is already being processed. Please wait a moment and check your order status before trying again. Оплаченный или предавторизованный заказ никогда не списывается повторно.

Если Moneris не отвечает (сетевая ошибка или тайм-аут), плагин отправляет в Moneris Status Check, чтобы выяснить, прошла ли транзакция. Если и это невозможно, заказ переводится в статус «На удержании» с номером заказа Moneris, и покупателя не просят платить во второй раз.

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

В плагине нет сохранённых карт и Moneris Vault, подписок WooCommerce, Apple Pay, Google Pay или Interac Online, Moneris Checkout или Hosted Tokenization, 3-D Secure, AVS или Kount, а также цен в нескольких валютах.

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

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

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

В обработке: покупка одобрена. Заказы, содержащие только виртуальные скачиваемые товары, переходят в статус «Выполнен» (значение WooCommerce по умолчанию). В примечании к заказу показаны сумма, ID транзакции Moneris и чек. ID транзакции — это номер транзакции Moneris.

На удержании: предавторизация одобрена и ожидает списания, обработанная сумма отличалась от суммы заказа, или Moneris не подтвердил результат. Примечание к заказу объясняет причину.

Отменён: для предавторизованного заказа отмена освобождает зарезервированные средства (void).

Списание и отмена

Чтобы списать предавторизованную сумму, переведите статус заказа в «В обработке» или «Выполнен» либо выберите Capture Moneris pre-authorization в действиях с заказом. Списывается текущая сумма заказа за вычетом возвратов; она не может превышать авторизованную сумму. Если Moneris отклоняет списание, статус возвращается в «На удержании» с примечанием, и письма о заказе в обработке или выполненном заказе не отправляются. Предавторизации Moneris истекают через несколько дней, поэтому списывайте их своевременно.

Чтобы освободить средства, отмените заказ или выберите Void Moneris pre-authorization (cancel order) в действиях с заказом. Перевод заказа в статус «Возвращён» также освобождает открытую предавторизацию. Если освободить средства не удалось, примечание попросит вас сделать это в Merchant Resource Center.

Возвраты

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

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

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

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

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

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

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

Moneris не появляется на странице оформления заказа: проверьте, что лицензия активна, Enable / Disable включён и в текущем режиме заданы Store ID и API Token. В рабочем режиме рабочие поля должны содержать ваши рабочие учётные данные, а не тестовые учётные данные Moneris. Проверьте, что валюта магазина (или валюта заказа на странице Pay for order) совпадает с валютой учётной записи: CAD для Канады, USD для учётной записи США. Страница настроек показывает предупреждение, если валюта не совпадает.

Платёж прошёл, но заказ остаётся в статусе «Ожидает оплаты» или «На удержании»: у плагина нет webhook; результат поступает только из ответа Moneris. Если заказ находится в статусе «На удержании» с примечанием, что Moneris не подтвердил результат, Moneris не ответил, и Status Check тоже не удался. Найдите номер заказа Moneris из примечания в Merchant Resource Center: если транзакция там есть, отправьте заказ (и при необходимости сделайте возврат там); если её нет, отмените заказ или попросите покупателя оплатить снова.

Покупатель видит Payment gateway is misconfigured. Please contact the store administrator.: не заполнены учётные данные текущего режима, либо включён рабочий режим, а в рабочих полях стоят тестовые учётные данные Moneris. Введите рабочие Store ID и API Token.

Покупатель видит This payment method does not support the order currency.: валюта заказа не совпадает с валютой учётной записи Moneris.

Покупатель видит ошибку при оплате: откройте примечания к заказу или включите Debug log и посмотрите WooCommerce > Status > Logs, источник wcp_moneris_gateway.

Списание не удаётся: у заказа нет предавторизации, ожидающей списания, сумма заказа равна нулю или сумма больше авторизованной. Предавторизации Moneris также истекают через несколько дней.

Возврат, списание или отмена не удаются с сообщением о режиме или учётной записи: платёж был произведён в тестовом или рабочем режиме, а учётные данные этого режима не заданы, либо платёж был произведён с учётной записью Moneris другой страны. Введите учётные данные или обработайте платёж в Merchant Resource Center.

Атаки перебора карт: формы карт, встроенные на сайт, являются целью для перебора карт. Включите ограничение частоты запросов на оформлении заказа WooCommerce, плагин CAPTCHA, а также правила eFraud или velocity в своей учётной записи Moneris.

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

Удаление

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

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