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. Плагин использует индийские адреса 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. По умолчанию: включено. Выключите его для реальных платежей.

Адрес возврата (Return URL)

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.

Способ оплаты работает в классическом оформлении заказа, в блоке «Оформление заказа» и на странице Pay for order. Он совместим с High-Performance Order Storage (HPOS) WooCommerce. Тексты для покупателя переведены на хинди.

Результат берётся только при возврате покупателя из CCAvenue: серверных уведомлений и запросов статуса нет. Если покупатель закрыл браузер до возврата, заказ остаётся в статусе Ожидание оплаты. Плагин не делает возвратов из WooCommerce, в нём нет сохранённых карт, подписок и регулярных платежей, iframe и формы карты на сайте, а также нет поддержки CCAvenue UAE и других региональных платформ.

Заказы

Статусы заказа

Pending payment: покупатель отправлен в CCAvenue и ещё не вернулся. Если покупатель не вернулся, проверьте платёж в панели CCAvenue.

Processing: оплата подтверждена (заказы только с виртуальными загружаемыми товарами переходят в статус Выполнен — стандартное поведение WooCommerce). В примечании к заказу показаны банковский референс, ID трекинга CCAvenue и режим оплаты. ID транзакции заказа — это ID трекинга CCAvenue.

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

On hold, awaiting bank confirmation: CCAvenue передал статус платежа "Awaited". Заказ никогда не переводится в статус Не удался, пока деньги могут быть ещё списаны. Проверьте платёж в панели CCAvenue перед выполнением заказа и смените статус вручную. Более поздний ответ с тем же ID трекинга всё равно применяется.

On hold, payment for a cancelled order: покупатель заплатил после отмены заказа. Проверьте остатки и выполните заказ или сделайте возврат.

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

Failed: платёж не прошёл или CCAvenue вернул Invalid, Timeout или другой неуспешный статус. В примечании показано сообщение CCAvenue. Запоздалый отказ никогда не меняет оплаченный заказ.

Если для уже оплаченного заказа приходит второй успешный платёж (например, из двух вкладок браузера), заказ больше не меняется. Примечание просит вернуть дубликат в панели CCAvenue.

Возвраты: возвраты из 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. Страница настроек показывает предупреждение, если чего-то не хватает.

Оплата прошла, но заказ остаётся в статусе Ожидание оплаты: покупатель не вернулся из 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, и что в тестовом режиме для вашей учётной записи включён тестовый доступ CCAvenue. Для валюты, отличной от INR, на вашей учётной записи CCAvenue должна быть включена мультивалютная обработка.

Покупатель видит This payment method is temporarily unavailable: одно из учётных данных не заполнено.

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

Заказ в статусе On hold после оплаты: прочитайте примечание к заказу. Оплаченная сумма или валюта отличались от заказа, платёж ожидает подтверждения банка или заказ был отменён. Проверьте платёж в панели 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 и не одобрен ею.