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 — це один архів із цієї сторінки. Без ключа він працює як безкоштовна версія.