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

IMPS

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

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

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

Запрос

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

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

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

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

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

Оплата

Запрос

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

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

Info

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

Ответ

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

Info

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

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

Запрос

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

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

Info

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

Ответ

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

Info

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

Запрос статуса операции

Запрос

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

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

Ответ

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

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

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

Оплата

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

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

Note

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

Запрос

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

Параметр Тип данных Описание
return_url * required
 string URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method object Секция параметров способа оплаты.
type * обязательный
 string imps
customer object Секция информации о покупателе.
first_name string Имя покупателя.
last_name string Фамилия покупателя.
phone
 string (10) Номер телефона покупателя.
email string Адрес электронной почты покупателя.
Пример запроса 
{
    "request": {
        "amount": 2000000,           
        "currency": "INR",                        
        "test": false,
        "description": "description",            
        "return_url": "https://someurl.com",
        "method": {
            "type": "imps"                
        }
    }
}
Ответ
Пример ответа 
{
    "transaction": {
        "uid": "c432436c-b153-4466-89f1-7ebb54203361",
        "type": "payment",
        "status": "pending",
        "amount": 2000000,
        "currency": "INR",
        "description": "description",
        "created_at": "2023-08-04T14:50:20Z",
        "updated_at": "2023-08-04T14:50:20Z",
        "method_type": "imps",
        "receipt_url": "https://my.riverbanq.com/customer/transactions/c432436c-b153-4466-89f1-7ebb54203361/cb5026d14acf395cc973902ef0e9516a60d2e09544266342767a45f36507ba3d",
        "payment": {
            "status": "pending",
            "gateway_id": 3073,
            "message": "Transaction created"
        },
        "imps": {
            "type": "imps"
        },
        "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/t4f9e9b3a-4223-4a97-965e-9c483fc8d163/12649778853",
            "method": "GET",
            "fields": []
        }
    }
}

Выплата

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

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

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

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string imps
account * обязательный
 string Номер банковского счета получателя выплаты.
ifsc_code * обязательный
 string IFSC- код банка получателя.
customer object Секция информации о покупателе.
first_name * обязательный
 string (35) Имя покупателя.
last_name * обязательный
 string (35) Фамилия покупателя.
id_number * обязательный
 string Идентификатор покупателя в системе торговца.
Пример запроса 
{
    "request": {
        "amount": 10,
        "currency": "INR",
        "description": "description",            
        "test": false,           
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "id_number": "1234567"
        },
        "method": {
            "type": "imps",
            "account": "1234",
            "ifsc_code": "ABCD0001238"
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "d1b8582b-c6e3-4b7d-8fd6-927a26fef68",
        "type": "payout",
        "status": "pending",
        "amount": 10,
        "currency": "INR",
        "description": "description",
        "created_at": "2023-08-04T11:05:22Z",
        "updated_at": "2023-08-04T11:05:23Z",
        "method_type": "imps",
        "receipt_url": "https://my.riverbanq.com/customer/transactions/d1b8582b-c6e3-4b7d-8fd6-927a26fef678/978ab9cfcf49e66dfe1bef13c5c81adbcaf9729e9ee7ee3858619f9091b4d3",
        "payout": {
            "status": "pending",
            "gateway_id": 3073,
            "message": "Payout request created"
        },
        "imps": {
            "type": "imps",
            "account": "123467911",
            "ifsc_code": "ABCD0001238"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "message": "Payout Request Created",            
        "test": false,
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "id_number": "1234567"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }
    }
}

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

Оплата

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

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

Info

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

Запрос

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

Параметр Тип данных Описание
request object
return_url * обязательный
 string URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method object Секция параметров способа оплаты.
type * обязательный
 string imps
customer * обязательный
 object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
email * обязательный
 string Адрес электронной почты покупателя.
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": "imps"
      }
  }
}
Ответ

Ответ на запрос выплаты средств будет дополнительно содержать секцию 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": "imps",
        "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."
        },
        "imps": {
            "type": "imps"
        },
        "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": []
        }
    }
}

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

Запрос

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

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string imps
account_number * обязательный
 string Идентификатор счета получателя выплаты.
ifsc_code * обязательный
 string IFSC- код банка получателя.
customer object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
external_id string Идентификатор покупателя в системе торговца.
Пример запроса 
{
  "request":{
      "amount":20000,
      "currency":"INR",
      "description":"description",
      "test": false,
      "tracking_id":"your_uniq_number",
      "ip":"127.0.0.1",
      "language":"en",
      "notification_url":"https://your-notification.url",
      "return_url":"https://your-success.url",
      "customer":{
        "first_name":"John",
        "last_name":"Doe"        
      },
      "method":{
        "type": "imps",
        "account_number": "123456789",
        "ifsc_code": "ICIC0002293"
      }
  }
}
Ответ
Пример ответа 
{
      "transaction": {
          "uid": "ea1d9cec-24b1-4436-b290-6ff713995909",
          "type": "payout",
          "status": "pending",
          "amount": 20000,
          "currency": "INR",
          "description": "description",
          "created_at": "2025-04-17T15:24:51Z",
          "updated_at": "2025-04-17T15:24:51Z",
          "manually_corrected_at": null,
          "method_type": "imps",
          "receipt_url": "https://my.riverbanq.com/customer/transactions/ea1d9cec-24b1-4436-b290-6ff713995909/d330742681e13ce43491120b804b9aefff61abd68ab3a5a56239ac935af87b62?language=en",
          "payout": {
              "status": "pending",
              "gateway_id": 5255,
              "ref_id": "njfvvmyya",
              "message": "Transaction was initialized."
          },
          "imps": {
              "type": "imps"
          },
          "customer": {
              "email": null,
              "ip": "127.0.0.1"
          },
          "version": 0,
          "message": "Transaction was initialized.",
          "tracking_id": "your_uniq_number",
          "test": false,
          "language": "en",
          "billing_address": {
              "first_name": "John",
              "last_name": "Doe"
          },
          "additional_data": {
              "payment_method": {
                  "type": "alternative"
              }
          }       
      }
}