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, і покупця не запрошують платити вдруге.

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

Плагін не підтримує збережені картки та Moneris Vault, WooCommerce Subscriptions, 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.

Атаки card testing: прямі форми карток є ціллю для card testing. Увімкніть обмеження частоти запитів для оформлення замовлення WooCommerce, плагін CAPTCHA, а також правила eFraud або velocity у своєму обліковому записі Moneris.

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

Видалення

Деактивація плагіна зберігає всі дані. Щоб видалити його, деактивуйте та видаліть плагін на сторінці Plugins. Ліцензійний ключ і статус ліцензії цього плагіна завжди видаляються. Налаштування шлюзу та журнали видаляються, лише якщо була увімкнена опція Delete data on uninstall. Інакше вони зберігаються для повторного встановлення. Наявні замовлення зберігають свої платіжні нотатки та ID транзакцій.

Moneris є торговельною маркою її власника. Цей плагін не пов'язаний з Moneris і не схвалений компанією Moneris.