VibeFox Authorize.Net for WooCommerce — Допомога

Вимоги

WordPress: 5.8 або новіша.

WooCommerce: 7.0 або новіша, встановлений і активний. Без WooCommerce плагін показує повідомлення в адміністративній частині, а спосіб оплати не завантажується.

PHP: 8.0 або новіша.

HTTPS: оформлення замовлення має працювати через HTTPS. Accept.js не запускається на звичайному HTTP.

Обліковий запис Authorize.Net: потрібні API Login ID, Transaction Key і Public Client Key вашого облікового запису Authorize.Net, а також Signature Key, якщо ви використовуєте вебхуки. Облікові записи робочого режиму (account.authorize.net) і тестового середовища (sandbox.authorize.net) мають різні облікові дані. Облікові записи Authorize.Net доступні мерчантам у США, Канаді, Великобританії, Європі, Австралії та Новій Зеландії.

Валюта: валюта магазину має бути USD, CAD, CHF, DKK, EUR, GBP, NOK, PLN, SEK, AUD або NZD, а ваш обліковий запис Authorize.Net має проводити розрахунки в ній. Для інших валют спосіб оплати приховується під час оформлення замовлення.

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

Встановлення

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

2. Натисніть Activate.

3. Відкрийте налаштування: WooCommerce > Settings > Payments > Authorize.Net > Manage або натисніть Settings під назвою плагіна на сторінці Plugins.

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

5. Введіть облікові дані тестового середовища та робочого облікового запису (див. розділ «Налаштування»). За бажанням налаштуйте вебхук.

6. Увімкніть Enable/Disable, оберіть Transaction type і збережіть. Протестуйте платіж у тестовому режимі карткою 4111 1111 1111 1111, будь-якою майбутньою датою закінчення дії та будь-яким CVV, а потім зніміть позначку з Sandbox mode.

Налаштування

Усі параметри розміщені на одній сторінці: WooCommerce > Settings > Payments > Authorize.Net. Над полями сторінка попереджає, якщо сайт не використовує HTTPS (Accept.js працює лише на сторінках HTTPS), і коли валюта магазину не підтримується (тоді спосіб оплати приховується під час оформлення замовлення). Сторінка показує лише поля облікових даних вибраного режиму.

Загальні

Enable/Disable: Enable Authorize.Net вмикає або вимикає спосіб оплати. За замовчуванням: вимкнено.

Title: назва способу оплати, яку бачать покупці під час оформлення замовлення. За замовчуванням: Credit Card.

Description: текст над формою карток під час оформлення замовлення. За замовчуванням: Pay securely with your credit card via Authorize.Net.

Облікові дані API

У Merchant Interface Authorize.Net відкрийте Account > Settings > Security Settings. У розділі API Credentials & Keys скопіюйте API Login ID і створіть Transaction Key та Signature Key. У розділі Manage Public Client Key скопіюйте Public Client Key. Тестове середовище та робочий режим використовують різні облікові дані.

Sandbox mode: Use the Authorize.Net sandbox (test transactions, no real charges). Перемикає адресу API, Accept.js і набір облікових даних нижче. За замовчуванням: увімкнено. Зніміть позначку, щоб приймати справжні платежі.

Live API Login ID і Sandbox API Login ID: API Login ID робочого облікового запису або облікового запису тестового середовища.

Live Transaction Key і Sandbox Transaction Key: Transaction Key цього облікового запису.

Live Public Client Key і Sandbox Public Client Key: публічний ключ, який Accept.js використовує в браузері.

Live Signature Key і Sandbox Signature Key: потрібні лише для вебхуків. Вони перевіряють заголовок X-ANET-Signature кожного сповіщення.

Оплата

Transaction type: спосіб списання з картки. Термін дії авторизації — 30 днів.

Вебхуки (рекомендовано)

Без вебхуків замовлення, утримані Fraud Detection Suite, або захоплені чи анульовані в панелі Authorize.Net, доведеться оновлювати вручну. У Merchant Interface перейдіть до Account > Settings > Business Settings > Webhooks і натисніть Add Endpoint. Використовуйте адресу, яку показано в цьому розділі налаштувань. Вона має вигляд https://your-site/wc-api/wc_authorizenet/. Оберіть такі події:

Введіть Signature Key облікового запису в поле Live Signature Key або Sandbox Signature Key. Вебхуки без дійсного підпису відхиляються. Для кожного сповіщення плагін також запитує в Authorize.Net поточний статус і суму транзакції, перш ніж змінити замовлення, тож повторні сповіщення нічого не змінюють.

Додатково

Debug log: Log API requests and responses записує до WooCommerce > Status > Logs, джерело wcp_authorizenet_gateway. Ключі, токени карток і персональні дані приховуються. За замовчуванням: вимкнено.

Delete data on uninstall: Remove the settings and the Authorize.Net order meta when the plugin is deleted. За замовчуванням: вимкнено.

Оформлення замовлення

Покупець обирає спосіб оплати (за замовчуванням Credit Card) і вводить номер картки, термін дії (MM/YY) та код безпеки (CVV) на сторінці оформлення замовлення. У тестовому режимі форма показує підказку з тестовою карткою 4111 1111 1111 1111. Після розміщення замовлення Accept.js обмінює дані картки на одноразовий токен у браузері. Поля карток не мають імен полів форми, тож номер картки та CVV ніколи не надсилаються на ваш сервер.

Плагін списує суму токеном через API Authorize.Net на суму замовлення у валюті замовлення. Адреса для рахунку, e-mail і IP-адреса надсилаються разом із транзакцією для перевірки адреси та фільтрів шахрайства. Якщо платіж схвалено, покупець переходить на сторінку підтвердження замовлення, а кошик очищується.

Якщо картку відхилено, покупець залишається на оформленні замовлення і бачить Payment failed: і причину, наприклад відхилену картку, неправильний код безпеки або прострочену картку. Помилки конфігурації та API покупцям не показуються: вони бачать загальне повідомлення, а подробиці потрапляють до примітки до замовлення та журналу. Якщо магазин не може підключитися до Authorize.Net, покупець бачить Payment error: unable to connect to the payment gateway. Please try again.

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

Плагін не має збережених карток чи профілів покупців, підписок і передзамовлень WooCommerce, eCheck/ACH, Apple Pay, Google Pay, PayPal або 3-D Secure, часткового захоплення авторизації та автоматичної конвертації валют.

Замовлення та повернення коштів

Статуси замовлення

Processing or Completed: картку списано (Authorize and capture) або авторизацію захоплено. WooCommerce встановлює Processing, а для замовлень лише з віртуальними товарами для завантаження — Completed. Примітка до замовлення показує суму, ID транзакції, код авторизації, тип картки та останні чотири цифри. ID транзакції — це Trans ID з Authorize.Net.

On hold: кошти лише авторизовано (Authorize only) або Fraud Detection Suite утримав транзакцію на перевірку. Схваліть або відхиліть утриману транзакцію в панелі Authorize.Net; за наявності вебхуків замовлення оновиться автоматично. Замовлення також переходить у статус On hold, якщо захоплення, про яке повідомив вебхук, не збігається із сумою замовлення.

Cancelled: вебхук повідомив, що транзакцію відхилено, анульовано або вона прострочена до оплати замовлення. Якщо це сталося з оплаченим замовленням, його статус не змінюється, а додається примітка-попередження.

Захоплення

Для замовлення з авторизацією відкрийте замовлення, оберіть Capture payment (Authorize.Net) у діях замовлення і натисніть кнопку оновлення. Захоплюється вся сума замовлення мінус повернення, а замовлення позначається оплаченим. Якщо захоплення не вдалося, помилку показано і додано до приміток замовлення. Захопити можна також у панелі Authorize.Net; за наявності вебхуків замовлення оновиться автоматично.

Повернення коштів

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Credit Card (кнопка використовує назву вашого способу оплати). Повернення на повну суму замовлення спершу анулює транзакцію, якщо вона ще не розрахована, або авторизацію, яку не захоплено. Розраховані транзакції, зазвичай через 24 години, можна повертати повністю або частково. До розрахунку часткове повернення неможливе: поверніть повну суму, щоб анулювати транзакцію, або спробуйте знову після розрахунку. Якщо Authorize.Net не приймає повернення, WooCommerce показує помилку, і повернення не записується. Успішне повернення або анулювання додається до приміток замовлення.

Повернення, захоплення та перевірки вебхуків для замовлення використовують облікові дані режиму, в якому його було оплачено, тож замовлення іншого режиму можна захоплювати та повертати й після перемикання Sandbox mode. Залиште облікові дані того режиму в полях, доки ці замовлення не опрацьовано.

Ліцензійний ключ

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

Один ключ працює на одному домені. Видалення ключа з сайту не звільняє слот домену. Звільніть слот в обліковому записі на vibefox.net.

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

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

Усунення несправностей

Authorize.Net не з'являється під час оформлення замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено і для поточного режиму заповнені API Login ID, Transaction Key і Public Client Key. Перевірте, що валюта магазину підтримується; сторінка налаштувань показує попередження, якщо ні.

Платіж пройшов, але замовлення залишається On hold: тип транзакції — Authorize only (захопіть її дією замовлення), або Authorize.Net утримав транзакцію на перевірку. Схваліть або відхиліть її в панелі Authorize.Net. Щоб такі замовлення оновлювалися автоматично, налаштуйте вебхук: перевірте, що адреса кінцевої точки точно така, як показано в налаштуваннях, що вибрано всі чотири події і введено Signature Key поточного режиму.

Вебхук відповідає webhooks are not configured: Signature Key не введено для жодного з режимів.

Вебхук відповідає invalid signature: Signature Key належить іншому обліковому запису або режиму. Створіть Signature Key знову або скопіюйте його і вставте в поле свого режиму.

Вебхук відповідає verification failed, retry later: магазин не зміг зчитати транзакцію через API Authorize.Net. Authorize.Net повторює доставку.

Форма карток не завантажується або показує повідомлення The secure card form (Accept.js) could not be loaded. Оформлення замовлення має працювати через HTTPS, а Public Client Key і API Login ID поточного режиму мають бути правильними.

Payment error: the card could not be tokenized: Accept.js не повернув токен. Покупцеві варто ввести дані картки знову та спробувати ще раз.

Покупець бачить загальну помилку: відкрийте примітки до замовлення або увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_authorizenet_gateway. Валюту, яку обліковий запис не підтримує, відхиляє Authorize.Net.

Часткове повернення не вдається, бо транзакція ще не розрахована: поверніть повну суму замовлення, щоб анулювати транзакцію, або повторіть спробу після розрахунку, зазвичай протягом 24 годин.

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

Видалення

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

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