NetBanking
Вариант интеграции RP
Для этого варианта интеграции поддерживаются следующие операции:
Оплата
Запрос
Отправьте запрос оплаты со следующими дополнительными параметрами:
Параметр | Тип данных | Описание |
---|---|---|
method | object | Секция параметров способа оплаты. |
type * обязательный |
string | net_banking |
customer | object | Секция информации о покупателе. |
first_name * обязательный |
string | Имя покупателя. |
last_name * обязательный |
string | Фамилия покупателя. |
country * обязательный |
Код страны покупателя. Установите в значении IN . |
|
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
Описание процесса оплаты
- Покупатель инициирует NetBanking оплату на странице торговца.
- Торговец отправляет запрос оплаты в Constantpos.
- Constantpos возвращает торговцу ссылку на страницу оплаты.
- Торговец перенаправляет покупателя на страницу оплаты.
- Покупатель совершает оплату.
- 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": []
}
}
}