Razorpay, PhonePe & Paytm Payments для OpenCart 2.3, 3.x і 4.x — UPI, картки й нетбанкінг в Індії

Razorpay, PhonePe & Paytm Payments — модуль оплати для OpenCart 4.x, 3.x і 2.3, який підключає індійські платіжні шлюзи Razorpay, PhonePe і Paytm з вашими власними акаунтами. Покупець платить на сторінці шлюзу через UPI, картку, нетбанкінг чи гаманець, а замовлення в OpenCart підтверджується лише тоді, коли модуль прочитав платіж з API шлюзу і звірив суму.

Це один метод оплати в OpenCart, а шлюз обирається всередині нього, тож два шлюзи на одному чекауті не конфліктують. У безкоштовній версії працює один основний шлюз, у Pro — до трьох поруч.

Що побачить покупець

На кроці оплати покупець бачить метод «UPI, cards, netbanking» з назвою шлюзу. У Pro, коли ввімкнено кілька шлюзів, під методом зʼявляється вибір: Razorpay, PhonePe або Paytm. Далі покупець переходить на сторінку оплати: для Razorpay відкривається його вікно оплати, PhonePe і Paytm приймають покупця на своїй сторінці.

Якщо магазин працює в доларах чи іншій валюті, покупець бачить суму в рупіях за курсом OpenCart. Якщо оплата не пройшла, покупець бачить «The payment did not go through. You can try again.» і кнопку повторної оплати, а замовлення не підтверджується.

Що отримує адмін

У налаштуваннях модуля ви обираєте основний шлюз, вводите ключі для тестового й бойового режиму, адресу вебхука для кабінету шлюзу й порядок статусів. Кнопка «Check connection» перевіряє ключі всіх трьох шлюзів і показує результат прямо в налаштуваннях.

У Pro на сторінці замовлення є вкладка модуля: перевірити оплату в шлюзі, зробити повне чи часткове повернення. Журнал платежів показує всі спроби: шлюз, суму, номер платежу в шлюзі, повернення і стан замовлення. Сторож за кроном перевіряє оплати, які покупець не завершив на сайті.

Як це працює — крок за кроком

1. Ви обираєте основний шлюз і вводите тестові ключі.
2. Копіюєте адресу вебхука в кабінет шлюзу.
3. Покупець оформлює замовлення і переходить на сторінку оплати.
4. Шлюз приймає UPI, картку чи нетбанкінг.
5. Модуль читає платіж з API шлюзу і звіряє суму й валюту.
6. Лише тоді замовлення отримує статус оплати, а в історії зʼявляється номер платежу.

Що під капотом

• Razorpay: Orders API і Standard Checkout, підпис HMAC, оплата читається зі списку платежів замовлення.
• PhonePe: PG Standard Checkout v2, токен OAuth кешується до кінця строку дії.
• Paytm: initiateTransaction і автоформа, чексума за алгоритмом офіційної бібліотеки Paytm.
• Жоден із трьох шлюзів не дає закрити неоплачений платіж, тому пізня оплата не губиться: модуль приймає її в замовлення або позначає для перевірки.
• Вебхук із секретом і неправильним підписом відхиляється, а рішення завжди за відповіддю API.
• Ключі не пишуться в журнал.

Як встановити

1. Розширення → Інсталятор: завантажте архів під свою версію, не змінюючи назву файлу.
2. OpenCart 2.3: Інсталятор копіює файли лише з увімкненим FTP. Без FTP скопіюйте вміст upload/ у корінь магазину вручну.
3. OpenCart 2.3 і 3.x: Розширення → Модифікації → «Оновити».
4. Розширення → Платежі → Razorpay, PhonePe & Paytm Payments → кнопка встановлення → Редагувати.
5. Розширення → Платежі → Razorpay, PhonePe & Paytm: оберіть основний шлюз і лишіть тестовий режим.
6. Вставте ключі, скопіюйте адресу вебхука в кабінет шлюзу, натисніть «Check connection».
7. Зробіть тестову оплату, потім перемкніть на бойовий режим.
8. Для Pro: вставте ключ або запустіть 7 днів тріалу.