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

Вимоги

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

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

PHP: 8.0 або новіша, з розширенням OpenSSL (використовується для шифрування запиту та розшифрування відповіді).

Обліковий запис CCAvenue: потрібен обліковий запис мерчанта CCAvenue з Merchant ID, Access Code і Working Key. Access Code та Working Key видаються для домену сайту, тож створіть їх для домену цього магазину. CCAvenue використовує ті самі облікові дані для тестового середовища; доступ до тесту має увімкнути для вашого облікового запису CCAvenue. Плагін використовує індійські адреси API CCAvenue.

Валюта: валюта замовлення передається в CCAvenue без змін. За замовчуванням облікові записи CCAvenue приймають INR; інші валюти потребують мультивалютної обробки у вашому обліковому записі CCAvenue.

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

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

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

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

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

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

5. Введіть Merchant ID, Access Code і Working Key з вашої панелі CCAvenue та увімкніть Enable/Disable.

6. Залиште Test mode увімкненим під час тестування, а потім вимкніть його, щоб приймати справжні платежі.

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

Усі параметри розміщено на одній сторінці: WooCommerce > Settings > Payments > CCAvenue. Над полями сторінка попереджає, якщо CCAvenue увімкнено, але не заповнено Merchant ID, Access Code або Working Key (тоді спосіб оплати приховано на оформленні замовлення, доки всі три поля не буде заповнено), показує CCAvenue test mode is on: customers are sent to test.ccavenue.com and no real money is taken., поки ввімкнено тестовий режим, і нагадує про мультивалютну обробку, якщо валюта магазину не INR.

Загальні

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

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

Description: текст під способом оплати на оформленні замовлення. За замовчуванням: Pay securely via Credit/Debit card, Net Banking, UPI or Wallet through CCAvenue.

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

Увійдіть до панелі мерчанта CCAvenue (M.A.R.S.) і відкрийте Settings > API Keys. Створіть Access Code і Working Key для домену цього магазину. Пробіли в облікових даних видаляються під час збереження.

Merchant ID: ваш числовий Merchant ID CCAvenue. Якщо він містить щось крім цифр, під час збереження з'являється помилка, і зберігається попередньо збережене значення.

Access Code: Access Code для цього веб-сайту.

Working Key: Working Key (ключ шифрування) для цього веб-сайту. Він шифрує запит на оплату і є єдиним способом перевірити відповідь CCAvenue, тож тримайте його в таємниці.

Test mode: Send customers to the CCAvenue test environment (test.ccavenue.com). CCAvenue використовує ті самі Merchant ID, Access Code і Working Key для тестового та робочого режимів; доступ до тесту має увімкнути для вашого облікового запису CCAvenue. У тестовому режимі на оформленні замовлення показується TEST MODE: no real transactions will be processed. За замовчуванням: увімкнено. Вимкніть його для справжніх платежів.

Адреса повернення

CCAvenue повертає покупця на адресу, яку показано в цьому розділі. Вона має вигляд https://your-site/wc-api/ccavenue_p_callback/. Плагін надсилає цю адресу з кожним платежем, тож у CCAvenue нічого налаштовувати не потрібно. Вона має належати домену, зареєстрованому в CCAvenue.

Додатково

Debug log: Log CCAvenue events записує ID замовлень, посилання CCAvenue та статуси до WooCommerce > Status > Logs, джерело wcp_ccavenue_payment. Ключі, дані картки та адреси не записуються. За замовчуванням: вимкнено.

Delete data on uninstall: Remove the plugin settings, logs and CCAvenue order references when the plugin is deleted. Деактивація плагіна ніколи нічого не видаляє. За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням CCAvenue) і оформлює замовлення. Сторінка Pay for order показує Thank you for your order. You are being redirected to CCAvenue to complete the payment. і надсилає покупця на платіжну сторінку CCAvenue. Без JavaScript покупець натискає Pay via CCAvenue або Cancel order. Кожна спроба отримує нове посилання на замовлення CCAvenue. Сума та валюта замовлення, платіжні та адреси доставки, а також ключ замовлення передаються у зашифрованому запиті. Імена та адреси очищаються до символів і довжин, які приймає CCAvenue; країна та штат передаються назвами, а телефон — лише цифрами.

Після оплати CCAvenue повертає покупця із зашифрованою відповіддю. Замовлення позначається оплаченим лише після того, як CCAvenue його підтвердить: відповідь має розшифруватися вашим Working Key, належати цьому замовленню і містити ту саму суму та валюту, що й замовлення. Потім покупець потрапляє на сторінку підтвердження замовлення.

Якщо платіж не проходить, покупець повертається на оформлення замовлення з повідомленням Payment was not completed. Please try again or choose a different payment method. Якщо покупець скасовує платіж на сторінці CCAvenue, повідомлення: Payment was cancelled. You may try again. Якщо відповідь неможливо перевірити, повідомлення: We could not confirm the payment result. If your account was charged, please contact us before paying again. Покупець може знову оплатити неоплачене замовлення, наприклад зі сторінки Pay for order. Якщо платіж розпочато зі сторінки Pay for order, а кошик порожній, WooCommerce показує повідомлення на сторінці кошика; невдале замовлення можна оплатити знову з розділу My account > Orders.

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

Результат береться лише з повернення покупця з CCAvenue: серверних повідомлень і запитів статусу немає. Якщо покупець закрив браузер до повернення, замовлення залишається в статусі Очікує оплати. Плагін не виконує повернення коштів з WooCommerce, не має збережених карток, підписок чи регулярних платежів, iframe або форми картки на сайті та не підтримує CCAvenue UAE чи інші регіональні платформи.

Замовлення

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

Pending payment: покупця перенаправлено на CCAvenue, і він ще не повернувся. Якщо покупець не повертається, перевірте платіж у панелі CCAvenue.

Processing: платіж підтверджено (замовлення лише з віртуальними товарами для завантаження переходять у статус «Виконано», стандартна поведінка WooCommerce). Примітка до замовлення показує банківський референс, tracking ID CCAvenue та режим оплати. ID транзакції замовлення — це tracking ID CCAvenue.

On hold, amount/currency mismatch: CCAvenue підтвердив платіж, сума або валюта якого відрізняється від замовлення, наприклад замовлення було змінено після початку оплати покупцем або застосовано знижку-пропозицію CCAvenue. Примітка показує отриману та очікувану суму. Перевірте платіж у панелі CCAvenue, а потім завершіть або поверніть замовлення.

On hold, awaiting bank confirmation: CCAvenue повідомив про платіж як Awaited. Замовлення ніколи не позначається невдалим, поки гроші ще можуть бути захоплені. Перевірте його в панелі CCAvenue перед виконанням і змініть статус вручну. Пізніша відповідь з тим самим tracking ID все одно застосовується.

On hold, payment for a cancelled order: покупець заплатив після того, як замовлення було скасовано. Перевірте запаси та виконайте замовлення або поверніть платіж.

Cancelled: покупець перервав платіж на сторінці CCAvenue.

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

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

Refunds: повернення з WooCommerce не підтримуються. Поверніть платіж у панелі CCAvenue і запишіть його в WooCommerce вручну.

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

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

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

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

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

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

CCAvenue не з'являється під час оформлення: перевірте, що ліцензія активна, Enable/Disable увімкнено і заповнено всі три облікові дані: Merchant ID, Access Code і Working Key. Сторінка налаштувань показує попередження, якщо одного з них бракує.

Платіж пройшов, але замовлення залишається Pending payment: покупець не повернувся з CCAvenue до вашого магазину, наприклад через закритий браузер. Плагін не має серверних повідомлень від сервера до сервера. Перевірте платіж у панелі CCAvenue і вручну оновіть замовлення.

Кожна оплата завершується повідомленням We could not confirm the payment result: відповідь неможливо розшифрувати. Working Key неправильний, належить іншому домену або скопійований з зайвими символами. Створіть ключі для домену цього магазину і вставте їх знову. Увімкніть Debug log і перегляньте WooCommerce > Status > Logs, джерело wcp_ccavenue_payment.

CCAvenue показує помилку перед платіжною сторінкою: перевірте, що Access Code і Working Key створено для цього домену, що адреса повернення належить домену, зареєстрованому в CCAvenue, і що в тестовому режимі для вашого облікового запису увімкнено доступ до тесту. Для валюти, відмінної від INR, у вашому обліковому записі CCAvenue має бути увімкнено мультивалютну обробку.

Покупець бачить This payment method is temporarily unavailable: бракує одних з облікових даних.

Покупець бачить Payment gateway error: encryption failed: запит не вдалося зашифрувати. Перевірте, чи встановлено розширення OpenSSL для PHP.

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

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

Для розробників у readme описано фільтр ccavenue_p_request_params (змінює дані, що передаються в CCAvenue, наприклад від merchant_param2 до merchant_param5 або promo_code; не змінюйте amount, currency, order_id чи merchant_param1) і фільтр ccavenue_p_icon для іконки на оформленні замовлення.

Видалення

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

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