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

Вимоги

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

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

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

HTTPS: ваш сайт має бути доступний з інтернету через HTTPS, щоб Cardcom міг надсилати повідомлення про оплату.

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

Обліковий запис Cardcom: для справжніх платежів потрібен обліковий запис мерчанта Cardcom з номером терміналу, API Username і API Password. Для платежів потрібні лише номер терміналу та API Username. API Password використовується лише для повернень з WooCommerce. Тестовий режим працює без облікового запису Cardcom.

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

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

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

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

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

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

5. Увімкніть Enable/Disable, залиште Test Mode увімкненим і оформіть тестове замовлення карткою 4580 0000 0000 0000, будь-якою майбутньою датою закінчення, CVV 123.

6. Для справжніх платежів зніміть позначку з Test Mode і введіть Terminal Number, API Username та API Password, отримані від Cardcom.

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

Усі параметри розміщено на одній сторінці: WooCommerce > Settings > Payments > Cardcom. Над полями сторінка показує Test mode is on., поки ввімкнено тестовий режим. У робочому режимі вона попереджає, якщо бракує номера терміналу або API Username (тоді Cardcom приховано на оформленні замовлення), і нагадує, що без API Password повернення з WooCommerce неможливі. Вона також попереджає, якщо валюта магазину не підтримується. Коли ви зберігаєте робочий режим без номера терміналу або API Username, повідомлення про помилку вказує, що спосіб оплати залишатиметься прихованим на оформленні замовлення, доки їх не буде введено.

Загальні

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

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

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

Тестовий режим

Тестовий режим використовує публічний тестовий термінал Cardcom 1000 (API user CardTest1994). Справжні гроші не списуються, обліковий запис Cardcom не потрібен. Тестова картка: 4580 0000 0000 0000, будь-яка майбутня дата закінчення, CVV 123. У тестовому режимі на оформленні замовлення також показується рядок із цією тестовою карткою.

Test Mode: Enable test mode (terminal 1000, no real money). За замовчуванням: увімкнено. Зніміть позначку, щоб приймати справжні платежі за робочими обліковими даними нижче. Повернення завжди надсилаються з обліковими даними того режиму, в якому було оплачено замовлення.

Робочі облікові дані

Номер терміналу, API Username і API Password надає Cardcom разом із вашим обліковим записом мерчанта: у панелі Cardcom у розділі API settings або через службу підтримки Cardcom. Ці поля використовуються лише в робочому режимі.

Terminal Number: номер вашого терміналу Cardcom. Він має містити лише цифри. Якщо введено інші символи, з'являється помилка, і зберігається попереднє значення.

API Username: ваш API username Cardcom (ApiName) для цього терміналу. Пробіли видаляються під час збереження.

API Password: ваш API password Cardcom. Він потрібен лише для повернень з WooCommerce і зберігається саме так, як введено.

Сторінка оплати

Cardcom надсилає повідомлення про оплату (IndicatorUrl) на адресу, яку показано в цьому розділі. Вона має вигляд https://your-site/wc-api/cardcom_p_callback/. Адреса автоматично передається Cardcom з кожним платежем разом з ID замовлення, тож у Cardcom нічого налаштовувати не потрібно. Вона має бути доступною з інтернету.

Operation: що Cardcom робить на платіжній сторінці.

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

Success Order Status: статус замовлення після підтвердженого платежу. Статус встановлюється одразу, без другої зміни статусу.

Додатково

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

Delete on Uninstall: Delete all plugin data when uninstalling. Якщо увімкнено, видалення плагіна безповоротно видаляє налаштування, дані Cardcom, збережені в замовленнях, і журнали. Самі замовлення зберігаються. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням Credit Card (Cardcom)) і оформлює замовлення. Плагін створює платіжну сторінку Cardcom на суму замовлення у валюті замовлення і надсилає покупця туди. Сторінка відкривається івритом, якщо мова сайту — іврит, інакше англійською. Позиції замовлення передаються в Cardcom як назви товарів. Покупець вводить дані картки і, якщо дозволено оплату частинами, обирає кількість платежів.

Після оплати покупець повертається на сторінку підтвердження замовлення вашого магазину. Замовлення позначається оплаченим лише після того, як Cardcom його підтвердить. Cardcom викликає адресу повідомлення, і плагін бере з цього виклику лише код платіжної сторінки. Він перевіряє, що цей код був виданий вашим магазином для цього замовлення, а потім запитує у Cardcom справжній результат від сервера до сервера. Якщо повідомлення надходить із запізненням, та сама перевірка виконується, коли покупець потрапляє на сторінку підтвердження замовлення.

Якщо оплату не завершено, Cardcom повертає покупця до оформлення замовлення (або на сторінку Pay for order), де показано The card payment was not completed. Please try again or choose a different payment method. Відхилений Cardcom платіж позначає замовлення статусом «Не вдалося». Покупець може знову оплатити неоплачене замовлення, наприклад зі сторінки Pay for order. Платіж, зроблений на старішій платіжній сторінці того самого замовлення, як і раніше розпізнається. Якщо покупець перейшов до іншого способу оплати, але заплатив на сторінці Cardcom, платіж записується, а спосіб оплати повертається на Cardcom.

Якщо Cardcom не може відкрити платіжну сторінку, покупець бачить коротке повідомлення, наприклад Could not connect to Cardcom. Please try again in a moment. або повідомлення, що Cardcom не зміг відкрити платіжну сторінку, разом із кодом Cardcom, і може обрати інший спосіб оплати.

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

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

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

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

Pending payment: покупця перенаправлено на Cardcom, і він ще не заплатив, або Cardcom ще не підтвердив платіж.

Processing, Completed or On Hold: платіж підтверджено. Статус відповідає налаштуванню Success Order Status. Примітка до замовлення показує транзакцію Cardcom, а також, коли Cardcom їх повідомляє, останні чотири цифри картки, номер рахунку та кількість частин. Тестові платежі позначаються Test mode — no real money was charged. ID транзакції замовлення — це номер угоди Cardcom (deal number).

On hold after payment: Cardcom підтвердив платіж, який не відповідає замовленню, наприклад суму замовлення змінили після відкриття платіжної сторінки, або списано іншу суму чи валюту. Примітка до замовлення пояснює це. Порівняйте платіж у панелі Cardcom із замовленням, а потім виконайте замовлення або поверніть платіж.

Failed: Cardcom відхилив платіж. Примітка до замовлення показує код відповіді Cardcom. Відмова за старішою платіжною сторінкою не відхиляє новішу спробу, а пізня відмова ніколи не змінює оплачене замовлення.

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

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

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

Повернення, зроблені в панелі Cardcom, не передаються назад у магазин. За потреби створіть ручне повернення в WooCommerce без Refund via цього способу оплати.

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

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

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

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

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

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

Cardcom не з'являється під час оформлення: перевірте, що ліцензія активна, Enable/Disable увімкнено і валюта замовлення — ILS, USD, EUR або GBP. У робочому режимі перевірте, що Terminal Number і API Username заповнені. Сторінка налаштувань показує попередження, коли чогось бракує.

Платіж пройшов, але замовлення залишається Pending payment: Cardcom не зміг достукатися до вашого сайту, наприклад через режим обслуговування, фаєрвол, захист паролем або локальний сайт для розробки. Адреса повідомлень має бути доступна з інтернету через HTTPS. Замовлення також підтверджується, коли покупець повертається на сторінку підтвердження замовлення. Увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_cardcom_payment_gateway.

Notification answers Missing or invalid lowprofilecode or Unknown lowprofilecode for this order: виклик не містив коду платіжної сторінки, виданого вашим магазином для цього замовлення. Замовлення не змінюється.

Notification answers Gateway not configured or Indicator check failed: бракує облікових даних того режиму, в якому створено платіжну сторінку, або не вдалося звернутися до Cardcom для перевірки. Замовлення не змінюється і перевіряється знову, коли покупець повертається до магазину.

Notification answers ReturnValue mismatch or Terminal mismatch: Cardcom повідомив про платіж для іншого замовлення або іншого терміналу. Замовлення не змінюється. Перевірте, що Terminal Number — це термінал вашого облікового запису.

Покупець бачить Payment error: this currency is not supported by Cardcom.: валюта замовлення — не ILS, USD, EUR або GBP.

Покупець бачить Card payment is temporarily unavailable. Please choose another payment method.: увімкнено робочий режим, але не заповнено номер терміналу або API Username.

Покупець бачить помилку під час оформлення замовлення: відкрийте примітки до замовлення або увімкніть Debug log і перегляньте журнал. Там записуються помилки з'єднання та коди помилок Cardcom.

Order is On hold after payment: прочитайте примітку до замовлення. Сума або валюта платежу не відповідали замовленню. Виконайте замовлення або поверніть платіж.

Refund fails with API username and API password are required for refunds: введіть API Password (і API Username) в налаштуваннях і спробуйте знову.

Refund fails with Could not connect to Cardcom: перед повторною спробою перевірте панель Cardcom, бо повернення могло бути або не бути зроблено.

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

Для розробників у readme описано фільтр cardcom_p_supported_currencies, який розширює список валют (додавайте лише ті валюти, які увімкнено на вашому терміналі Cardcom).

Видалення

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

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