UPI
Вариант интеграции PZ
Описание процесса оплаты
- Плательщик выбирает UPI в качестве способа оплаты.
- Торговец запрашивает номер кошелька у PaySage.io и отображает его клиенту.
- Плательщик делает перевод на указанный кошелек.
- Плательщик копирует идентификатор транзакции из квитанции и вводит его на платежной форме торговца.
- Торговец создает платеж через PaySage.io API и передает идентификатор транзакции.
- Далее PaySage.io активирует платеж и уведомляет торговца, когда транзакция будет завершена.
Для этого варианта интеграции поддерживаются следующие типы транзакций:
Запрос номера кошелька
Запрос
Отправьте GET запрос на https://api.paysage.io/beyag/pkm/upi/wallet/{currency}, где {currency} - это валюта в формате ISO-4217, например USD.
Ответ
В ответ будет получен статус код 200, если запрос был обработан успешно, или не успешно.
Пример успешного ответа
{
"wallet": "123456789",
"status": "ok"
}
Пример ответа в случае ошибки
{
"status": "fail",
"message": "An error has occurred while fetching a wallet. Try again later, please."
}
Оплата
Запрос
Note
Поддерживаемые валюты и страны уточняйте у аккаунт менеджера.
После того как плательщик отправит вам идентификатор транзакции, необходимо отправить запрос оплаты со следующими данными:
|
|||||||||||||||||||||||||||||
Ответ
Секция upi из ответа на запрос будет иметь все те же параметры, что были присланы в запросе, а также один дополнительный параметр form с необходимыми параметрами, чтобы сформировать веб-форму для перехода на оплату.
Выплата средств
Запрос
Info
Дробная часть суммы игнорируется. Например, если передан amount = 123456, тогда актуальный amount будет 123400.
Отправьте запрос выплаты средств со следующими данными:
|
|||||||||||||||||||
Ответ
Секция imps_ib из ответа на запрос будет иметь все те же параметры, что были присланы в запросе.
Вариант интеграции PF
Для этого варианта интеграции поддерживается тип транзакций оплата:
Оплата
Описание процесса оплаты
- Покупатель выбирает UPI в качестве способа оплаты на сайте торговца и указывает свой VPA (Virtual Payment Address).
- Торговец отправляет запрос оплаты в PaySage.io, указав VPA покупателя.
- PaySage.io возвращает торговцу статус оплаты:
pendingилиfailed. - Покупатель получает запрос подтверждения оплаты в своем аккаунте приложения UPI.
- Покупатель подтверждает оплату в приложении UPI.
- PaySage.io высылает торговцу автоматическое уведомление со статусом
successful,failedилиpending.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 10042,
"currency": "INR",
"description": "description",
"test": false,
"customer": {
"first_name": "John",
"last_name": "Doe",
"state": "KA",
"city": "Bangalore",
"zip": "560002",
"address": "1st Street",
"phone": "17777777777",
"email": "user@example.com"
},
"method": {
"type": "upi",
"account": "1234"
}
}
}
Ответ
Секция upi в ответе будет содержать те же параметры, что и в запросе.
Вариант интеграции PF (QR)
Оплата
Описание процесса оплаты
- Покупатель выбирает UPI в качестве способа оплаты на сайте торговца и указывает свой VPA (Virtual Payment Address).
- Торговец отправляет запрос оплаты в PaySage.io, указав VPA покупателя.
-
PaySage.io возвращает торговцу ответ с тремя ссылками:
- ссылка на QR-код;
- deeplink для перенаправления покупателя в приложение UPI;
- ссылка на веб-страницу, где размещена и ссылка для перехода в приложение UPI, и QR-код.
-
Торговец перенаправляет покупателя на одну из ссылок из ответа.
- Покупатель завершает оплату в приложении UPI.
- PaySage.io высылает торговцу автоматическое уведомление со статусом транзакции.
Запрос
Отправьте запрос оплаты, указав следующие дополнительные параметры:
|
|||||||||||||||||||||||||||||||||||
Пример запроса
{
"request": {
"amount": 20000,
"currency": "INR",
"description": "description",
"duplicate_check": false,
"test": false,
"expired_at": "2026-01-01T15:00:00+01:00",
"tracking_id": "your_uniq_number",
"ip": "127.0.0.1",
"language": "en",
"notification_url": "https://merchant.ltd/notification",
"return_url": "https://merchant.ltd/return",
"customer": {
"first_name": "John",
"last_name": "Doe",
"middle_name": "Mid",
"country": "IN",
"state": "KA",
"city": "Bangalore",
"zip": "560002",
"address": "1st Street",
"phone": "17777777777",
"device_id": "12312312321fff67",
"email": "example@example.com"
},
"method": {
"account": "BE11-EF898-251F-A949",
"type": "upi_qr_deeplink"
}
}
}
Ответ
Отправьте покупателя на один из следующих URL-адресов:
additional_data.payment_method.qr_code– чтобы отобразить покупателю QR-код для сканирования мобильным устройством;additional_data.payment_method.deeplink– чтобы перенаправить покупателя в приложение UPI;form.action– чтобы перенаправить покупателя на HTML страницу, где размещены и QR-код и кнопка перехода в приложение UPI.
Пример ответа
{
"transaction": {
"uid": "05482b9d-2ec9-4844-8763-55fc3195c9ef",
"type": "payment",
"status": "pending",
"amount": 20000,
"currency": "INR",
"description": "description",
"created_at": "2025-07-12T10:07:52Z",
"updated_at": "2025-07-12T10:07:52Z",
"method_type": "upi_qr_deeplink",
"receipt_url": "https://backoffice.paysage.io/customer/transactions/05482b9d-2ec9-4844-8763-55fc3195c9ef/27b5379b2b6796c4d9ef9f2d850000190fac077da124f4d8b14e370b4a737c27?language=en",
"payment": {
"status": "pending",
"gateway_id": 5374,
"ref_id": "178648809",
"message": "Transaction was initialized"
},
"upi_qr_deeplink": {
"type": "upi_qr_deeplink",
"account": "BE11-EF898-251F-A949"
},
"customer": {
"zip": "560002",
"city": "Bangalore",
"email": "example@example.com",
"phone": "17777777777",
"state": "KA",
"address": "1st Street",
"country": "IN",
"device_id": "12312312321fff67",
"last_name": "Doe",
"first_name": "John",
"middle_name": "Mid",
"ip": "127.0.0.1"
},
"manually_corrected_at": null,
"version": 1,
"message": "Transaction was initialized",
"tracking_id": "your_uniq_number",
"test": false,
"language": "en",
"expired_at": "2026-01-01T14:00:00Z",
"billing_address": {
"zip": "560002",
"city": "Bangalore",
"email": "example@example.com",
"phone": "17777777777",
"state": "KA",
"address": "1st Street",
"country": "IN",
"device_id": "12312312321fff67",
"last_name": "Doe",
"first_name": "John",
"middle_name": "Mid"
},
"additional_data": {
"payment_method": {
"type": "alternative",
"qr_code": "data:image/png;base64,",
"deeplink": "upi:/"
}
},
"gateway": {
"iframe": false
},
"form": {
"action": "https://api.paysage.io/beyag/transactions/redirect/05482b9d-2ec9-4844-8763-55fc3195c9ef",
"method": "GET",
"fields": []
}
}
}