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

Вимоги

WordPress: 6.0 або новіша версія.

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

PHP: 8.0 або новіша версія.

Обліковий запис Razorpay: вам потрібні Key ID і Key Secret вашого облікового запису Razorpay для тестового режиму, а для робочого режиму — після активації облікового запису. Наполегливо рекомендовано вебхук із секретом на ваш вибір (див. розділ Налаштування). Платежі у валютах, відмінних від INR, потребують увімкненого International Payments в обліковому записі Razorpay.

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

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

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

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

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

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

5. Введіть Test Key ID і Test Key Secret, налаштуйте вебхук у Razorpay Dashboard і введіть його секрет (див. розділ Налаштування).

6. Увімкніть Enable/Disable і виконайте тестовий платіж із увімкненим Test mode. Коли все готово, введіть ключі Live і вимкніть Test mode.

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

Усі налаштування розміщено на одній сторінці: WooCommerce > Settings > Payments > Razorpay. Над полями сторінка показує повідомлення: відсутні ключі поточного режиму (тоді спосіб оплати приховано в оформленні замовлення), Key ID не починається з rzp_test_ у тестовому режимі чи з rzp_live_ у робочому, увімкнено тестовий режим, секрет вебхука порожній, або валюта магазину не INR і потребує увімкненого International Payments в обліковому записі Razorpay. У списку способів оплати Razorpay позначено як такий, що потребує налаштування, доки в поточному режимі немає ключів, а поки тестовий режим увімкнено, відображається позначка Test mode. Пробіли, вставлені разом із ключами, видаляються під час збереження.

Загальні

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

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

Description: текст, що відображається під способом оплати в оформленні замовлення. За замовчуванням: Pay securely via UPI, Credit/Debit Card, or Internet Banking through Razorpay.

Ключі API

Ключі можна отримати в Razorpay Dashboard у розділі Account & Settings > API Keys. Переключіть Dashboard у тестовий режим, щоб створити тестові ключі (rzp_test_...). Робочі ключі (rzp_live_...) доступні після активації облікового запису.

Test mode: Use the Test mode keys (no real money is charged). За замовчуванням: увімкнено. Вимкніть, щоб приймати реальні платежі. Платежі, захоплення та повернення замовлення завжди використовують ключі того режиму, у якому замовлення було оплачено, тож зміна режиму згодом не впливає на наявні замовлення.

Test Key ID: Key ID з Razorpay Dashboard у тестовому режимі. Починається з rzp_test_.

Test Key Secret: Key Secret з Razorpay Dashboard у тестовому режимі.

Live Key ID: Key ID з Razorpay Dashboard у робочому режимі. Починається з rzp_live_.

Live Key Secret: Key Secret з Razorpay Dashboard у робочому режимі.

Оплата

Payment Action: момент списання коштів. За замовчуванням: Authorize & Capture.

Authorize & Capture: покупець платить одразу. Якщо Razorpay повідомляє про авторизований платіж, плагін його захоплює.

Authorize Only: кошти резервуються. Замовлення переходить у статус «На утриманні», а платіж ви захоплюєте пізніше дією із замовленням Capture Razorpay payment або в Razorpay Dashboard. Razorpay автоматично повертає авторизовані платежі, які не були захоплені вчасно.

Вебхук

Вебхук підтверджує платежі навіть тоді, коли покупець закриває браузер одразу після оплати, і фіксує повернення, зроблені в Razorpay Dashboard. У Razorpay Dashboard перейдіть до Account & Settings > Webhooks і додайте вебхук для тестового режиму та ще один для робочого. Використовуйте URL, який показано в цьому розділі налаштувань. Він має вигляд https://your-site/wc-api/razorpay_p_webhook/. Скопіюйте його точно так, як його показують налаштування. Вкажіть у Razorpay секрет на ваш вибір і оберіть такі події:

payment.authorized: платіж авторизовано.

payment.captured: платіж захоплено, зокрема коли ви захоплюєте його в Razorpay Dashboard.

payment.failed: спроба оплати не вдалася.

order.paid: замовлення Razorpay, до якого належить платіж, оплачено.

refund.created: платіж повернуто, наприклад у Razorpay Dashboard.

Webhook Secret: секрет, який ви вказали під час створення вебхука. Використовуйте той самий секрет для тестового і робочого вебхука, бо в плагіні одне поле для обох. Вебхуки без дійсного підпису відхиляються. Без вебхука платіж підтверджується лише тоді, коли покупець повертається з вікна або згодом знову відкриває сторінку оплати замовлення.

Додатково

Enable Logging: Save debug logs. Журнал розташовано в WooCommerce > Status > Logs, джерело wcp_razorpay_payment. Помилки та попередження завжди записуються в журнал; ця опція додає відлагоджувальні деталі. Ключі, підписи та контактні дані покупців ніколи не записуються в журнал. За замовчуванням: вимкнено.

Delete Data on Uninstall: Remove the plugin settings and logs when the plugin is deleted (orders are never touched). За замовчуванням: вимкнено.

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

Покупець обирає спосіб оплати (за замовчуванням UPI, Cards, NetBanking) і оформлює замовлення. Плагін створює замовлення Razorpay на точну суму замовлення та його валюту і відкриває сторінку оплати замовлення. Вікно Razorpay Checkout відкривається там автоматично, з уже заповненими іменем, e-mail і телефоном покупця. Якщо вікно закрито, покупець може натиснути Pay Now, щоб відкрити його знову, або Cancel order. У тестовому режимі сторінка показує Razorpay Test mode: no real money will be charged.

Після успішної оплати плагін перевіряє підпис Razorpay, отримує платіж через API Razorpay і порівнює суму та валюту із замовленням. Замовлення позначається оплаченим лише після підтвердження Razorpay. Далі покупець бачить сторінку отримання замовлення. Якщо підпис дійсний, але платіж у цей момент отримати не вдалося, замовлення переходить у статус «На утриманні», а вебхук підтвердить його пізніше.

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

Повідомлення, які бачить покупець:

Payment was cancelled. Please click "Pay Now" to try again.

Your session has expired. Please click "Pay Now" to try again.

We could not verify your payment. У повідомленні додано, що замовлення буде оновлено автоматично, щойно Razorpay підтвердить списання, якщо кошти були списані.

Razorpay is temporarily unavailable. Please try again in a few minutes.

Razorpay could not accept this payment: далі вказано причину від Razorpay.

The order amount is too small to be paid with Razorpay.

Razorpay Checkout could not be loaded. Скрипт вікна заблоковано; повідомлення просить перевірити з'єднання, вимкнути блокувальники контенту та перезавантажити сторінку.

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

Плагін приймає лише разові платежі. Він не підтримує підписки та регулярні платежі, збережені картки, Razorpay Magic Checkout, Payment Links і Route (розділені платежі), а також віджети пропозицій або доступності платежу.

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

Order statuses

Pending payment: замовлення Razorpay створено, а покупець ще не сплатив. Кожне замовлення Razorpay додається до приміток замовлення з його сумою та режимом.

Processing or Completed: платіж захоплено та підтверджено; це стандартний статус WooCommerce після оплати. Примітка замовлення містить ID платежу Razorpay, суму та спосіб підтвердження (зворотний виклик, вебхук або перевірка при поверненні). ID транзакції — це ID платежу Razorpay (pay_...).

On hold: встановлюється в таких випадках, кожен із приміткою замовлення: платіж лише авторизовано (Authorize Only), оплачена сума або валюта не збігаються із замовленням, платіж захоплено для скасованого замовлення або платіж не вдалося перевірити через API Razorpay у цей момент. Замовлення, яке вже має статус «На утриманні», теж отримує примітку.

Failed: вебхук payment.failed надійшов для замовлення, що очікує оплати. Примітка показує помилку Razorpay. Покупець усе ще може оплатити знову; замовлення, яке вже має авторизований або захоплений платіж, не змінюється.

Cancelled: покупець натиснув Cancel order, або замовлення скасували ви чи таймаут резервування запасу WooCommerce. Платіж, що надійде пізніше, не відкриває його автоматично: авторизований платіж не захоплюється, а захоплений платіж переводить замовлення в статус «На утриманні» для вашої перевірки.

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

Захоплення (Authorize Only)

Відкрийте замовлення в статусі «На утриманні», оберіть Capture Razorpay payment у Order actions і натисніть кнопку оновлення. Платіж захоплюється в режимі, у якому його було авторизовано, і замовлення стає оплаченим. Якщо Razorpay відмовляє, примітка замовлення показує Razorpay capture failed: із причиною. Захоплення, зроблене в Razorpay Dashboard, завершує замовлення через вебхук.

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

Відкрийте замовлення, натисніть Refund, введіть суму та натисніть Refund via, після чого вкажіть назву способу оплати. Підтримуються повні та часткові повернення. Повернення надсилається з ключами того режиму, у якому було здійснено платіж. Якщо Razorpay не приймає повернення, WooCommerce показує Razorpay refund failed: із причиною, і повернення не реєструється. Успішне повернення додається до приміток замовлення з ID повернення Razorpay, сумою та статусом.

Повернення, зроблені в Razorpay Dashboard, надходять через вебхук і реєструються в замовленні як повернення WooCommerce, один раз і без повернення товарів на склад. Повернення з Dashboard в іншій валюті або більше за суму, що підлягає поверненню, не реєструється автоматично; примітка пропонує зареєструвати його вручну.

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

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

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

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

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

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

Razorpay не відображається в оформленні замовлення: перевірте, що ліцензія активна, Enable/Disable увімкнено і в поточному режимі є обидва ключі: Test Key ID і Test Key Secret у тестовому режимі, Live Key ID і Live Key Secret у робочому. Сторінка налаштувань показує повідомлення, коли їх немає.

Платіж пройшов, але замовлення залишається Pending payment: вебхук не працює. У Razorpay Dashboard перевірте, що вебхук існує в режимі, який ви використовуєте (Test або Live), що його URL точно збігається з показаним у налаштуваннях і що вибрано всі п'ять подій. Перевірте, що Webhook Secret — це той самий секрет, що й у Razorpay. Замовлення також підтверджується, коли покупець знову відкриває сторінку оплати замовлення.

Вебхук відповідає Webhook secret not configured: Webhook Secret порожній. Введіть секрет вебхука Razorpay. Razorpay надішле подію повторно пізніше.

Вебхук відповідає Invalid signature або Missing signature: секрет у налаштуваннях відрізняється від секрету вебхука Razorpay. Введіть однаковий секрет в обох місцях.

Вебхук відповідає Retry later: плагіну не вдалося підтвердити захоплення через API Razorpay або замовлення в цей момент оновлювалося іншим запитом. Razorpay автоматично надішле подію повторно.

Замовлення має статус On hold: прочитайте примітку до замовлення. Платіж лише авторизовано (використовуйте Capture Razorpay payment), сума або валюта не збіглися із замовленням, платіж надійшов для скасованого замовлення, або його не вдалося перевірити через API Razorpay в цей момент, і він очікує на вебхук.

Покупець бачить помилку під час оплати: відкрийте примітки до замовлення або перегляньте WooCommerce > Status > Logs, джерело wcp_razorpay_payment. Помилки записуються в журнал навіть за вимкненої опції Enable Logging. Неправильні ключі дають повідомлення, що спосіб оплати наразі недоступний. Інші причини від Razorpay показуються після Razorpay could not accept this payment:.

Вікно оплати не відкривається: скрипт Razorpay Checkout заблоковано блокувальником контенту або з'єднанням. Покупець бачить повідомлення і може перезавантажити сторінку.

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

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

Видалення

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

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