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

NetBanking

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

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


Оплата

Запрос

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

Параметр Тип данных Описание
method object Секция параметров способа оплаты.
type * обязательный
string net_banking
customer object Секция информации о покупателе.
first_name * обязательный
string Имя покупателя.
last_name * обязательный
string Фамилия покупателя.
country * обязательный
Код страны покупателя. Установите в значении IN.
email string Адрес электронной почты покупателя.
city * обязательный
string Город покупателя.
state * обязательный
Двузначный код региона/области покупателя, например MH.
zip * обязательный
string Почтовый индекс покупателя.
address * обязательный
string Адрес покупателя.
phone * обязательный
string Номер телефона покупателя.
Ответ

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


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

Запрос

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

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
string net_banking
account * обязательный
string Номер счёта в банке получателе.
account_name * обязательный
string Имя получателя в банке получателя.
bank_name * обязательный
string Наименование банка получателя.
bank_code * обязательный
string IFSC-код банка получателя.
bank_branch_code * обязательный
string Название филиала банка получателя.
region_account * обязательный
string Адрес банка получателя.
customer object Секция информации о покупателе.
country * обязательный
string Код страны получателя (2-е цифры ISO), например IN.
id_number * обязательный
string Имя пользователя покупателя.
Ответ

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

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

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


Запрос списка поддерживаемых банков

Запрос

Для получения списка поддерживаемых банков отправьте GET запрос на https://api.constantpos.com/beyag/gateways/{gateway_id}/bank_list, где gateway_id - это идентификатор платежного шлюза, который активирован для вашего магазина для обработки платежей NetBanking. Чтобы получить идентификатор шлюза, обратитесь в Службу поддержки или к вашему менеджеру.

Ответ

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

Идентификаторы и названия банков, поддерживаемые платежным методом NetBanking, содержатся в массиве допустимых значений параметра data.net_banking.method.channel. Передайте id требуемого банка в запросе оплаты.


Оплата

Запрос

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

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

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

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

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

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

Оплата

Запрос

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

Параметр Тип данных Описание
request object
return_url * обязательный
string URL, на который будет возвращен покупатель после завершения операции в платёжной системе.
method object Секция параметров способа оплаты.
type * обязательный
string net_banking
customer * обязательный
object Секция информации о покупателе.
first_name * обязательный
string Имя покупателя.
last_name * обязательный
string Фамилия покупателя.
email * обязательный
string (100) Адрес электронной почты покупателя.
phone * обязательный
string Номер телефона покупателя.
country string Страна покупателя в формате ISO 3166-1 alpha-2.
city string Город покупателя.
zip string Почтовый индекс покупателя.
address string Адрес покупателя.
Пример запроса
{
  "request": {
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "test": false,
    "return_url": "https://someurl.com",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "country": "IN",
      "phone": "1770000077",
      "email": "user@example.com"
    },
    "method": {
      "type": "net_banking"
    }
  }
}
Ответ

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

Пример ответа
{
    "transaction": {
        "uid": "9c27d028-7b0e-4ced-9a32-d65a623c07a7",
        "type": "payment",
        "status": "pending",
        "amount": 20000,
        "currency": "INR",
        "description": "description",
        "created_at": "2023-12-22T11:26:59Z",
        "updated_at": "2023-12-22T11:27:00Z",
        "method_type": "net_banking",
        "receipt_url": "https://my.constantpos.com/customer/transactions/9c27d028-7b0e-4ced-9a32-d65a623c07a7/9567f4ebd9d2d7ca21b07642c236ae7d3eb892fb2c75d972ce431857771e44d8",
        "payment": {
            "status": "pending",
            "gateway_id": 3559,
            "message": "Transaction was initialized."
        },
        "net_banking": {
            "type": "net_banking"
        },
        "customer": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "user@example.com",
            "country": "IN",
            "phone": "17700000777777",
            "ip": null
        },
        "manually_corrected_at": null,
        "message": "Transaction was initialized.",
        "test": false,
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "email": "user@example.com",
            "country": "IN",
            "phone": "17700000777777"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        },         
        "gateway": {
            "iframe": true
        },
        "form": {
            "action": "payment-url/9c27d028-7b0e-4ced-9a32-d65a623c07a7",
            "method": "POST",
            "fields": []
        }
    }
}