VibeFox Tranzila for WooCommerce — Допомога

Вимоги

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

WooCommerce: 8.0 або новіша, встановлений і активний. Плагін не активується без нього.

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

Валюта магазину: ILS, USD, EUR або GBP. Для інших валют спосіб оплати приховується на етапі оформлення замовлення.

Термінал Tranzila: потрібна назва терміналу. Пароль терміналу (TranzilaPW) потрібен для handshake та для повернень коштів з WooCommerce. Деяким терміналам для повернень також потрібен окремий кредитний пароль (CreditPass). Назву терміналу та паролі надає Tranzila: їх можна знайти в налаштуваннях терміналу або уточнити у служби підтримки Tranzila. Публічної пісочниці (sandbox) у Tranzila немає. Для тестування Tranzila надає окремий тестовий термінал; вкажіть його назву як назву терміналу.

Справжня IP-адреса відвідувача: повідомлення про платежі перевіряються за IP-адресою сервера Tranzila. Якщо ваш сайт працює за проксі або CDN, наприклад Cloudflare, веб-сервер має передавати в PHP справжню IP-адресу відвідувача (REMOTE_ADDR).

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

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

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

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

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

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

5. Укажіть Terminal name (supplier), а якщо ви використовуєте handshake або повернення коштів, — Terminal password (TranzilaPW).

6. Залиште Notifications увімкненим і перевірте Trusted IP: там мають бути IP-адреси, з яких Tranzila надсилає повідомлення. Уточніть список у служби підтримки Tranzila.

7. Рекомендовано: увімкніть handshake у терміналі Tranzila, дозвольте там IP-адресу вашого сервера, а потім увімкніть Handshake у плагіні.

8. Увімкніть Enable/Disable і протестуйте платіж на тестовому терміналі Tranzila.

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

Усі налаштування розміщені на одній сторінці: WooCommerce > Settings > Payments > Tranzila. Над полями сторінка попереджає: якщо назва терміналу порожня, спосіб оплати приховується на етапі оформлення замовлення; якщо повідомлення вимкнено або Trusted IP порожній, оплачені замовлення переводяться в статус «на утриманні» для ручної перевірки; якщо handshake увімкнено без пароля терміналу, сторінка оплати не відкривається; якщо валюта магазину не підтримується. Під час збереження некоректна назва терміналу або некоректний запис у Trusted IP не зберігаються: сторінка показує помилку, а попереднє значення залишається. Числа поза допустимим діапазоном замінюються найближчим допустимим значенням.

General

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

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

Description: текст, який відображається під способом оплати на етапі оформлення замовлення. За замовчуванням: Pay securely with your credit card on the Tranzila payment page.

Terminal

Terminal name (supplier): назва вашого терміналу Tranzila, наприклад myshop. Лише літери, цифри, «-» та «_». Поки її не введено, спосіб оплати не відображається на етапі оформлення замовлення. Для тестів укажіть назву вашого тестового терміналу Tranzila.

Terminal password (TranzilaPW): API-пароль терміналу. Потрібен для handshake та для повернень коштів з WooCommerce.

Refund password (CreditPass): заповнюйте, лише якщо ваш термінал вимагає окремий пароль для кредитних операцій (повернень). В іншому разі залиште порожнім.

Payment page

Payment page version: сторінка Tranzila, яка відображається у фреймі.

Payment page language: мова сторінки Tranzila: Site language, Hebrew, English, Russian, Spanish, German, French або Japanese. За замовчуванням: Hebrew. Site language використовує мову локалі WordPress відвідувача, якщо вона входить до цього списку, інакше English.

iFrame width (px): від 300 до 1200. За замовчуванням: 600. На малих екранах фрейм ніколи не ширший за сторінку.

iFrame height (px): від 400 до 1500. За замовчуванням: 650.

Max installments: максимальна кількість платежів у розстрочку (tashlumim), яку покупець може обрати на сторінці оплати, до 36. 0 або 1 означає без розстрочки. За замовчуванням: 0. Термінал має бути дозволений для обробки розстрочки.

Handshake: Lock the amount with a handshake token (recommended). Перед відкриттям сторінки оплати магазин запитує в Tranzila одноразовий токен, прив'язаний до суми замовлення, тож суму не можна змінити в браузері. Для цього потрібні пароль терміналу, увімкнений handshake у терміналі Tranzila і дозволена там IP-адреса вашого сервера. За замовчуванням: вимкнено.

Payment confirmation

Повідомлення Tranzila не підписуються. Замовлення позначається оплаченим, лише якщо повідомлення надійшло з Trusted IP, а його ключ замовлення, термінал, сума та валюта збігаються із замовленням. Якщо handshake увімкнено, токен також має збігатися зі сторінкою оплати замовлення. Повернення покупця зі сторінки оплати ніколи не позначає замовлення оплаченим.

Notifications: Confirm payments automatically with Tranzila notifications (notify URL). За замовчуванням: увімкнено. URL для повідомлень передається в Tranzila з кожним платежем, тож вводити його в терміналі Tranzila не потрібно. Він має вигляд https://your-site/wc-api/tranzila_p_callback/ і показується під полем. Коли повідомлення вимкнені, покупець, який повертається зі сторінки успішної оплати, переводить замовлення на утримання, а ви підтверджуєте платіж вручну після перевірки в терміналі Tranzila.

Trusted IP: IP-адреси або діапазони CIDR серверів Tranzila, які надсилають повідомлення, через кому. За замовчуванням: 80.244.170.7. Актуальний список уточніть у служби підтримки Tranzila. Повідомлення з інших адрес відхиляються. Якщо поле порожнє, повідомлення не можна перевірити: повідомлення про успішний платіж переводить замовлення на утримання для ручної перевірки, а повідомлення про відмову не змінює замовлення.

Advanced

Debug log: Log payment page, notification and refund events записує події до WooCommerce > Status > Logs, джерело wcp_tranzila_payment_gateway. Помилки записуються завжди, навіть коли цю опцію вимкнено. Паролі, токени та дані покупців ніколи не записуються. За замовчуванням: вимкнено.

Delete data on uninstall: Delete the settings, logs and Tranzila order data when the plugin is deleted. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Credit Card (Tranzila)) і натискає Continue to payment. Замовлення створюється зі статусом Очікує оплати, і покупець переходить на сторінку оплати замовлення вашого магазину. Там відкривається сторінка оплати Tranzila у фреймі з сумою замовлення у валюті замовлення, платіжними даними та коротким списком замовлених товарів. На сторінці написано: Enter your card details on the secure Tranzila payment page below. If it does not load, click "Proceed to payment". Посилання Choose another payment method розміщене під фреймом. Якщо розстрочка дозволена, покупець обирає кількість платежів на сторінці Tranzila.

Після успішної оплати Tranzila повертає покупця, і все вікно переходить на сторінку «Замовлення отримано» вашого магазину. Замовлення позначається оплаченим лише після того, як Tranzila підтвердить платіж повідомленням. До того часу сторінка показує: Your payment is being confirmed by Tranzila. You will receive an e-mail as soon as it is confirmed — there is no need to pay again. Якщо замовлення перебуває на утриманні для перевірки, відображається: Your payment is being reviewed by the store. You will receive an e-mail once it is confirmed.

Якщо платіж відхилено або скасовано, покупець повертається на сторінку оплати замовлення з повідомленням The payment was not completed. You have not been charged — please try again or choose another payment method. Якщо Tranzila надсилає код відповіді, до повідомлення додаються причина і код, наприклад що строк дії картки минув. Покупець може оплатити знову або обрати інший спосіб оплати.

Якщо сторінку оплати не вдається відкрити, наприклад через помилку handshake, покупець бачить коротке повідомлення на кшталт Could not connect to Tranzila. Please try again in a moment. та посилання Choose another payment method. Технічна причина записується в журнал.

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

Плагін приймає лише разові платежі карткою на сторінці Tranzila. Він не підтримує збережені картки та токени, підписки, окремі авторизацію та списання (J5), власні кнопки Bit, Apple Pay чи Google Pay (усе, що пропонує ваша сторінка оплати Tranzila, відображається всередині фрейма) та рахунки Tranzila.

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

Order statuses

Pending payment: покупця відправили на сторінку оплати, і він ще не оплатив замовлення, або повідомлення від Tranzila ще не надійшло.

Processing or Completed: оплату підтверджено перевіреним повідомленням. WooCommerce встановлює статус Обробляється, або Виконано для замовлень без доставки. Примітка до замовлення показує суму, транзакцію Tranzila і номер авторизації, а також кількість платежів у розстрочку, якщо вона є. ID транзакції — це індекс транзакції Tranzila.

On hold: платіж отримано, але його не прийнято автоматично: сума, валюта або токен handshake не збіглися із замовленням; повідомлення не вдалося перевірити, оскільки Trusted IP порожній; або повідомлення вимкнені, а покупець повернувся зі сторінки успішної оплати. Примітка до замовлення пояснює причину. Перевірте платіж у терміналі Tranzila і змініть статус вручну.

Failed: Tranzila повідомила про відхилений платіж для замовлення, що очікує оплати. Примітка показує код відповіді та його значення. Вже оплачене замовлення ніколи не переводиться в статус Failed.

Якщо платіж надходить для скасованого замовлення, замовлення відкривається знову з приміткою, яка просить перевірити залишки перед відправленням. Якщо покупець на сторінці Pay for order змінив спосіб оплати, але сплатив на сторінці Tranzila, яка ще була відкрита, спосіб оплати замовлення повертається на Tranzila. Якщо другий платіж надходить для вже оплаченого, виконаного або повернутого замовлення, замовлення не змінюється. Примітка просить перевірити його і повернути дубль у терміналі Tranzila. Повторні повідомлення про ту саму транзакцію ігноруються.

Refunds

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via Credit Card (Tranzila) (кнопка показує назву способу оплати). Підтримуються повні та часткові повернення. Повернення виконується як кредитна операція Tranzila за початковим платежем. Кнопка доступна, якщо задано пароль терміналу і в замовлення є підтверджена транзакція Tranzila з номером авторизації. Успішне повернення додається до приміток замовлення разом із кредитною операцією Tranzila.

Якщо Tranzila не приймає повернення, WooCommerce показує помилку, наприклад Tranzila declined the refund з кодом, і повернення не фіксується. Замовлення, оплачене на іншому терміналі, ніж той, що вказаний зараз у налаштуваннях (наприклад, на тестовому), не можна повернути з WooCommerce; поверніть його в цьому терміналі Tranzila. Повернення, зроблені в терміналі Tranzila, магазину не повідомляються. За потреби створіть ручне повернення в WooCommerce без кнопки Tranzila.

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

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

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

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

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

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

Tranzila does not appear at checkout: перевірте, що ліцензія активна, Enable/Disable увімкнено, поле Terminal name (supplier) заповнене і валюта магазину (на сторінці Pay for order — валюта замовлення) є ILS, USD, EUR або GBP. Сторінка налаштувань показує попередження, якщо назву терміналу не вказано або валюта не підтримується.

The payment went through, but the order stays Pending payment: повідомлення не надійшло або його відхилено. Перевірте, що Notifications увімкнено і що Trusted IP містить адреси, з яких Tranzila надсилає повідомлення. Помилки завжди записуються в WooCommerce > Status > Logs, джерело wcp_tranzila_payment_gateway. Повідомлення про те, що IP-адреси немає у списку Trusted IP, означає, що потрібно виправити налаштування Trusted IP або конфігурацію проксі: за проксі або CDN веб-сервер має передавати в PHP справжню IP-адресу відвідувача.

Notification answers Forbidden: повідомлення надійшло з IP-адреси, якої немає в Trusted IP.

Notification answers Bad request or Not found: замовлення, його ключ, термінал або індекс транзакції в повідомленні не відповідають жодному замовленню цього магазину.

Notification answers Accepted for manual review: Trusted IP порожній, тому повідомлення не вдалося перевірити. Успішний платіж переводить замовлення на утримання. Заповніть Trusted IP, щоб підтверджувати платежі автоматично.

Notification answers Busy, retry: замовлення в цей самий момент оброблявся іншим запитом, і повідомлення не було застосовано. Перевірте платіж у терміналі Tranzila; якщо замовлення ще очікує оплати, а платіж там схвалено, змініть статус вручну.

Some paid orders are On hold: прочитайте примітку до замовлення. Сума, валюта або токен handshake не збіглися, або повідомлення не вдалося перевірити (Trusted IP порожній або повідомлення вимкнено). Перевірте платіж у терміналі Tranzila і змініть статус вручну.

The payment page does not open with the handshake on: перевірте назву та пароль терміналу, чи увімкнено handshake у терміналі Tranzila і чи дозволено там IP-адресу вашого сервера. У журналі вказано причину.

Refunds fail: для повернень потрібен Terminal password (TranzilaPW). Деякі термінали також вимагають окремий кредитний пароль; введіть його в Refund password (CreditPass). Замовлення, оплачені на іншому терміналі, потрібно повертати в цьому терміналі.

Other currencies: плагін підтримує ILS, USD, EUR та GBP. Розробники можуть змінити цей список за допомогою фільтра tranzila_p_currency_map.

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

Видалення

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

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