India Payments для WooCommerce — Razorpay, PhonePe и Paytm: UPI, карты и нетбанкинг

India Payments — плагин WooCommerce для магазинов в Индии, который подключает три платёжных шлюза: Razorpay, PhonePe и Paytm. Покупатель платит на странице шлюза через UPI, карту, нетбанкинг или кошелёк, а магазин получает деньги на свой аккаунт в шлюзе. Вы включаете один шлюз или все три, и покупатель выбирает удобный на чекауте.

Главное правило плагина: заказ становится оплаченным только тогда, когда API шлюза подтвердил платёж. Ссылка возврата и вебхук лишь запускают проверку, поэтому поддельный возврат или потерянный вебхук не дадут «оплаченного» заказа без денег.

Что увидит покупатель

На чекауте покупатель видит шлюзы, которые вы включили, с коротким описанием: «Razorpay — UPI, cards, netbanking», «PhonePe — UPI, cards, netbanking», «Paytm — UPI, wallet, cards, netbanking». После «Place order» Razorpay открывает своё окно оплаты, PhonePe и Paytm переводят покупателя на свою страницу.

Если UPI-платёж ещё в обработке, на странице благодарности покупатель видит сообщение, что магазин ждёт подтверждения, и страница сама обновляется. Если оплата не прошла, покупатель возвращается на страницу оплаты заказа с понятным текстом, корзина на месте, попробовать можно ещё раз или другим способом. Если шлюз не отвечает, покупатель остаётся на чекауте с сообщением без технических кодов.

Что получает админ

В WooCommerce → India Payments видны все три шлюза: включён ли, режим, адрес вебхука для кабинета шлюза и кнопка «Check connection». В настройках каждого шлюза вы вводите ключи тестового и боевого режима, секрет вебхука, название магазина в окне оплаты.

Каждая попытка оплаты оставляет в заказе одну заметку с номером платежа шлюза. Если сумма или валюта не совпали, заказ становится «На удержании» с пояснением. В Pro возврат делается кнопкой в заказе, а плагин следит за его статусом в шлюзе и пишет заметную заметку, если возврат не прошёл.

Как это работает — шаг за шагом

1. В кабинете Razorpay, PhonePe или Paytm вы берёте ключи тестового режима.
2. Вводите их в настройках шлюза, копируете адрес вебхука в кабинет шлюза.
3. Жмёте «Check connection» и делаете тестовую оплату.
4. Покупатель выбирает шлюз и платит на его странице.
5. Плагин спрашивает API шлюза о платеже и сверяет сумму и валюту.
6. Только после этого заказ становится оплаченным, а в заметках появляется номер платежа.

Что под капотом

• Razorpay: Orders API и Standard Checkout, подпись HMAC для возврата и вебхука, авторизованный платёж плагин захватывает сам.
• PhonePe: PG Standard Checkout v2, токен OAuth обновляется сам, вебхук проверяется по SHA256 логина и пароля.
• Paytm: initiateTransaction, автоформа на страницу Paytm, проверка чексуммы и статуса через API.
• У каждой попытки оплаты свой номер, поэтому повторная попытка после отказа не путается с предыдущей.
• Блокировка в базе не даёт двум процессам дважды отметить один платёж.
• Ключи и секреты хранятся зашифрованными, в журнал не пишутся.

Как установить

1. Плагины → Добавить новый → Загрузить плагин: выберите zip и активируйте.
2. WooCommerce → India Payments: включите нужные шлюзы и оставьте тестовый режим.
3. Вставьте ключи и секрет вебхука, скопируйте адрес вебхука в кабинет шлюза.
4. Нажмите «Check connection» и сделайте тестовую оплату, потом переключите на боевой режим.
5. Для Pro: вставьте ключ или запустите 7 дней триала.

На wordpress.org модуля пока нет: и бесплатная версия, и Pro — это один архив с этой страницы. Без ключа он работает как бесплатная версия.