Перейти к содержанию

UPI

Вариант интеграции QP

Для этого варианта интеграции поддерживаются следующие типы транзакций:

Оплата

Запрос

Info

Уточните поддерживаемые валюты и страны у аккаунт менеджера.

Отправьте запрос оплаты со следующими дополнительными параметрами:

Параметр Тип данных Описание
method object Секция параметров способа оплаты.
type * обязательный
 string upi
account * обязательный
 string Аккаунт в UPI.
customer object Cекция информации о покупателе.
first_name * обязательный
 string Имя клиента.
last_name * обязательный
 string Фамилия клиента.
email * обязательный
 string Адрес электронной почты клиента.
Ответ

Секция upi из ответа на запрос будет иметь все те же параметры, что были присланы в запросе, а также один дополнительный параметр form с необходимыми параметрами, чтобы сформировать веб-форму для перехода на оплату.

Выплата средств

Запрос

Отправьте запрос выплаты средств со следующие дополнительные параметры:

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string upi
account * обязательный
 string Аккаунт в UPI.
customer object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
email * обязательный
 string Адрес электронной почты покупателя.
address * обязательный
 string Адрес покупателя.
phone * обязательный
 string 10 цифр номера телефона покупателя без кода страны.
Ответ

Секция upi из ответа на запрос будет иметь все те же параметры, что были присланы в запросе.

Вариант интеграции EP

Для этого варианта интеграции поддерживаются следующие типы транзакций:

Оплата

Запрос

Отправьте запрос оплаты со следующими дополнительными параметрами:

Параметр Тип данных Описание
method object Секция параметров способа оплаты.
type * обязательный
 string upi

Info

Минимальная сумма платежа - 300 индийских рупий (передается как 30000).

Ответ

Ответ на запрос оплаты будет дополнительно содержать секцию form. Для завершения платежа направьте клиента на URL, переданный как значение параметра form.action.

Info

У клиента есть только 15 минут на подтверждение платежа.

Выплата средств

Запрос

Отправьте запрос выплаты средств со следующими дополнительными данными:

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string upi

Info

Минимальная сумма выплаты - 3000 индийских рупий (передается как 300000).

Ответ

Ответ на запрос выплаты средств будет дополнительно содержать секцию form. Направьте клиента на URL, переданный как значение параметра form.action.

Info

У клиента есть только 15 минут на подтверждение выплаты средств.

Запрос статуса транзакции

Запрос

Если в запросе на проведение оплаты или выплаты был передан параметр notification_url, система Riverbanq высылает вам автоматическое уведомление о статусе транзакции. Обратите внимание! Riverbanq может потребоваться некоторое время на получение подтверждения статуса транзакции от провайдера способа оплаты.

Если необходимо дополнительно узнать статус транзакции, отправьте запрос получения статуса.

Ответ

Ответ будет содержать статус транзакции, секцию параметров способа оплаты, а также иную информацию согласно описанию запроса на получение статуса транзакции.

Вариант интеграции PZC

Для этого варианта интеграции поддерживается тип транзакции оплата:

Оплата

Описание процесса оплаты

  1. Покупатель выбирает UPI в качестве способа оплаты.
  2. Торговец отправляет запрос оплаты в Riverbanq.
  3. Покупателю отображается страница с данными для осуществления платежа.
  4. Покупатель копирует реквизиты или сканирует QR код, и совершает оплату удобным для себя способом.
  5. Покупатель перенаправляется на return_url, где отображается статус оплаты.
  6. Riverbanq высылает торговцу автоматическое уведомление.

Note

Значение параметра amount в автоматическом уведомлении и в ответе на запрос статуса может отличаться от значения, присланного в первоначальном запросе на оплату, и будет равно фактической сумме платежа согласно информации в системе провайдера.

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр Тип данных Описание
return_url *обязательный
 string URL, на который будет перенаправлен покупатель после завершения транзакции в платёжной системе.
method *обязательный
 object Секция параметров способа оплаты.
type *обязательный
 string upi
user_id *обязательный
 string Уникальный идентификатор покупателя.
customer object Секция информации о покупателе.
first_name string Имя покупателя.
last_name string Фамилия покупателя.
phone
 string (10) Номер телефона покупателя.
email string Адрес электронной почты покупателя.
Пример запроса 
{
    "request": {
        "amount": 10000,
        "currency": "INR",
        "description": "description",
        "test": false,
        "return_url": "someurl.com",          
        "method": {
            "type": "upi",
            "user_id": "09fce47f-ae55-402f-a181-cc4fab2f2644"              
        }
    }
}
Ответ
Пример ответа 
{
    "transaction": {
        "uid": "c3984a12-c9e4-4470-822b-3334a1e841",
        "type": "payment",
        "status": "pending",
        "amount": 200000,
        "currency": "INR",
        "description": "description",
        "created_at": "2023-08-04T09:17:51Z",
        "updated_at": "2023-08-04T09:17:51Z",
        "method_type": "upi",
        "receipt_url": "https://my.riverbanq.com/customer/transactions/c3984a12-c9e4-4470-822b-3334a1e841/42e9373ede400bfadf09c6edb4628f2ae46de96d01e56be28d98932d37226580",
        "payment": {
            "status": "pending",
            "gateway_id": 3073,
            "message": "Transaction created"
            },
        "upi": {
            "type": "upi",
            "user_id": "09fce47f-ae55-402f-a181-cc4fab2f2644"
        },
        "customer": {
            "email": null,               
            "ip": null
            },
        "message": "Transaction created",            
        "test": false,
        "additional_data": {
             "payment_method": {
                 "type": "alternative"
            }
        },
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "https://checkout.pzc.com/payment/t2118183a-0bce-4ba2-9c20-12adf99e133d/83236352389",
            "method": "GET",
            "fields": []
        }
    }
}

Вариант интеграции PE

Оплата

Описание процесса оплаты

  1. Покупатель инициирует UPI оплату на странице торговца.
  2. Торговец отправляет запрос оплаты в Riverbanq.
  3. Riverbanq возвращает торговцу ссылку на страницу оплаты.
  4. Торговец перенаправляет покупателя на страницу оплаты.
  5. Покупатель совершает оплату.
  6. Riverbanq высылает торговцу автоматическое уведомление.

Info

Этот вариант интеграции поддерживает только валюту INR.

Запрос

Отправьте запрос оплаты, указав следующие дополнительные параметры:

Параметр Тип данных Описание
request object
return_url * обязательный
 string URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method object Секция параметров способа оплаты.
type * обязательный
 string upi
customer * обязательный
 object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
email * обязательный
 string (100) Адрес электронной почты покупателя.
phone * обязательный
 string Номер телефона покупателя.
external_id string Идентификатор покупателя в системе торговца.
Пример запроса 
{
  "request":{
      "amount":20000,
      "currency":"INR",
      "description":"description",
      "duplicate_check": false,
      "test": false,      
      "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",       
        "phone":"17777777777",       
        "email": "[email protected]"
      },
      "method":{
        "type": "upi"
      }
  }
}
Ответ

Ответ на запрос выплаты средств будет дополнительно содержать секцию form. Направьте покупателя на URL, переданный как значение параметра form.action.

Пример ответа 
{
    "transaction": {
        "uid": "87802f06-270d-4dde-bca3-49c799d0949c",
        "type": "payment",
        "status": "pending",
        "amount": 20000,
        "currency": "INR",
        "description": "description",
        "created_at": "2025-04-17T14:43:25Z",
        "updated_at": "2025-04-17T14:43:25Z",
        "method_type": "upi",
        "receipt_url": "https://my.riverbanq.com/customer/transactions/87802f06-270d-4dde-bca3-49c799d0949c/8cf133b729330a339c117270420b430918847ae4ee86f7b45e247a1a232adad5?language=en",
        "payment": {
            "status": "pending",
            "gateway_id": 5255,
            "message": "Transaction was initialized."
        },
        "upi": {
            "type": "upi"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone": "17777777777",
            "ip": "127.0.0.1"
        },
        "manually_corrected_at": null,
        "version": 0,
        "message": "Transaction was initialized.",
        "tracking_id": "your_uniq_number",
        "test": false,
        "language": "en",
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "[email protected]",
            "phone": "17777777777"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },       
        "gateway": {
            "iframe": false
        },
        "form": {
            "action": "payment-link",
            "method": "GET",
            "fields": []
        }
    }
}