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 дней триала.