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

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 из ответа на запрос будет иметь все те же параметры, что были присланы в запросе.

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

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

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

Запрос

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

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string imps
sender_wallet_id * обязательный
 string Номер кошелька (номер телефона) отправителя выплаты.
account * обязательный
 string Номер банковского счета получателя выплаты.
bank_name * обязательный
 string Название банка получателя выплаты.
ifsc_code * обязательный
 string IFSC- код банка получателя.
customer object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
phone * обязательный
 string 10 цифр номера телефона получателя выплаты без кода страны.
address * обязательный
 string Адрес получателя выплаты.
zip * обязательный
 string Почтовый индекс получателя выплаты.

Info

Допустимый размер выплаты составляет от 100 до 200000 INR.

Response

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

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

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

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

Запрос

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

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

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

Запрос статуса выплаты

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

Запрос

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

Ответ

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

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

Эта интеграция поддерживает транзакцию выплаты:

Выплата

Запрос

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

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string imps
account * обязательный
 string Номер счета в IMPS.
bank_name * обязательный
 string Название банка получателя выплаты.
ifsc_code * обязательный
 string IFSC- код банка получателя.
account_name * обязательный
 string Имя владельца счета в IMPS.
customer object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
address * обязательный
 string Адрес покупателя.
state * обязательный string (2) Штат покупателя. Укажите 2 последних символа из геокода формата ISO 3166-2.
city * обязательный string Город покупателя.
zip * обязательный string (6) Почтовый индекс покупателя.
phone string (14) Номер телефона покупателя.
email string Адрес электронной почты покупателя.
Пример запроса 
{
    "request":{
        "amount":30000,
        "currency":"INR",
        "description":"description",
        "test": true,
        "language":"en",
        "notification_url":"https://merchant.ltd/notification",
        "customer":{
            "first_name":"John",
            "last_name":"Doe",
            "city":"Delhi",
            "zip":"96002",
            "address":"1st Street",
            "state": "DL"
        },
        "method":{
            "type":"imps",
            "account": "123456789",
            "account_name": "John Doe",
            "ifsc_code": "ABCD0001234",
            "bank_name": "BANK0000123"
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "e1236a41-b26c-489e-a0ea-3419aab1e123",
        "type": "payout",
        "status": "pending",
        "amount": 30000,
        "currency": "INR",
        "description": "description",
        "created_at": "2023-06-02T09:33:13Z",
        "updated_at": "2023-06-02T09:33:15Z",
        "method_type": "imps",
        "receipt_url": "https://my.constantpos.com/customer/transactions/e4bb6a41-b26c-489e-a0ea-3419aab1e7c2/6842440302ab6927e88198c825c458d36a852e9dba8d44b980689d8fe8b112cb?language=en",
        "payout": {
            "status": "pending",
            "gateway_id": 1234,
            "ref_id": "4322647",
            "message": "Transaction was initialized"
        },
        "imps": {
            "type": "imps",
            "account": "123456789",
            "account_name": "John Doe",
            "ifsc_code": "ABCD0001234",
            "bank_name": "BANK0000123"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "message": "Transaction was initialized",
        "tracking_id": "your_uniq_number",
        "test": true,
        "language": "en",
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe",
            "country": "IN",
            "state": "DL",
            "city": "Delhi",
            "zip": "96002",
            "address": "1st Street"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }
    }
}

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

Эта интеграция поддерживает тип транзакции выплата:

Выплата

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

  1. Торговец формирует запрос выплаты в Constantpos, содержащий amount, account_name, account и ifsc_code.
  2. Constantpos отправляет торговцу промежуточный статус pending (транзакция обрабатывается) или возвращает ошибку.
  3. После завершения обработки транзакции Constantpos отправляет торговцу автоматическое уведомление со статусом транзакции: success или declined.
  4. Constantpos высылает email уведомления о статусе транзакции торговцу и покупателю, если включены соответствующие настройки.

Info

Из-за замедления работы серверов провайдера не рекомендуется проводить выплаты в период с 21:00 до 23:00 IST (15:30—17:30 UTC).

Запрос

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

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string imps
account_name * обязательный
 string (50) Имя владельца счета получателя выплаты.
account * обязательный
 string (50) Номер банковского счета получателя выплаты.
ifsc_code * обязательный
 string IFSC- код банка получателя.

Info

Минимальная сумма выплаты 500 индийских рупий. Максимальная сумма транзакции 200000 индийских рупий. Значение `amount` должно быть передано в минимальных денежных единицах, например, 50000 для 500 INR.
Пример запроса 
{
    "request":{
        "amount":50001,
        "currency":"INR",
        "description":"description",
        "test": false,            
        "method":{
            "type":"imps",
            "account": "123456789",                
            "ifsc_code": "ABCD0001234",
            "account_name": "John Doe"                  
        }
    }
}
Ответ

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

Пример ответа 
{
    "transaction": {
        "uid": "e8db4800-500a-46d7-b3fc-9f0068975458",
        "type": "payout",
        "status": "pending",
        "amount": 50001,
        "currency": "INR",
        "description": "description",
        "created_at": "2023-07-26T15:03:42Z",
        "updated_at": "2023-07-26T15:03:43Z",
        "method_type": "imps",
        "receipt_url": "https://my.constantpos.com/customer/transactions/e8db4900-500a-46d7-b3fc-9f0068975458/7f20310d5d02582ff3afg3db9c26a67906b0684a9a61dc41f3147f04e1068e79?language=en",
        "payout": {
            "status": "pending",
            "gateway_id": 3031,
            "ref_id": "b0c1c9f926e17a6dcb097658214a7b",
            "message": "Initialized"
            },
        "imps": {
            "type": "imps",
            "account": "123456789",
            "account_name": "John Doe",
            "ifsc_code": "ABCD0001234"
            },
        "customer": {
            "email": null,
            "ip": null
            },
        "message": "Initialized",
        "test": true,
        "language": "en",
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }
    }
}

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

Выплата

Процесс выплаты

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

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

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

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

Пример ответа 
{
    "transaction": {
        "uid": "7e5313d5-9e20-4baa-8ffb-8401d1ca0cd7",
        "type": "payout",
        "status": "pending",
        "amount": 1000,
        "currency": "INR",
        "description": "description",
        "created_at": "2023-12-14T10:17:45Z",
        "updated_at": "2023-12-14T10:17:45Z",
        "manually_corrected_at": null,
        "method_type": "imps",
        "receipt_url": "https://my.constantpos.com/customer/transactions/7e5313d5-9e20-4baa-8ffb-8401d1ca0cd7/8b08db25d1dbbdeb7ba122ce13362ab479421e013dcb19e7da5f22dd313ead48",
        "payout": {
            "status": "pending",
            "gateway_id": 3523,
            "ref_id": "7e5313d5-9e20-4baa-8ffb-8401d1ca0cd7",
            "message": "010 SUCCESS"
        },
        "imps": {
            "type": "imps",
            "account_number": "50322135136578",
            "ifsc_code": "HDFC325",
            "bank_name": "BANK0000123"
        },
        "customer": {
            "email": null,
            "ip": null
        },
        "message": "010 SUCCESS",
        "test": false,
        "billing_address": {
            "first_name": "John",
            "last_name": "Doe"
        },
        "additional_data": {
            "payment_method": {
                "type": "alternative"
            }
        }           
    }
}

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

Выплата

Процесс выплаты

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

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

Параметр Тип данных Описание
method object Секция параметров способа выплаты.
type * обязательный
 string imps
account_number * обязательный
 string Номер банковского счета получателя выплаты.
ifsc_code * обязательный
 string IFSC-код банка получателя выплаты.
bank_name * обязательный
 string Название банка получателя выплаты.
customer object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
phone * обязательный
 string Номер телефона покупателя.
Пример запроса 
{
  "request": {
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "test": false,
    "return_url": "https://someurl.com",
    "customer": {
      "first_name": "John",
      "last_name": "Doe",
      "phone": "123789105"
    },
    "method": {
      "type": "imps",
      "bank_name": "Bank",
      "ifsc_code": "HDFC325",
      "account": "11185058447"
    }
  }
}
Ответ

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

Пример ответа 
{
  "transaction": {
    "uid": "5063c831-0ba0-485b-a0d8-d1314256a486",
    "type": "payout",
    "status": "pending",
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "created_at": "2023-12-26T08:38:49Z",
    "updated_at": "2023-12-26T08:38:49Z",
    "manually_corrected_at": null,
    "method_type": "imps",
    "receipt_url": "https://my.constantpos.com/customer/transactions/5063c831-0ba0-485b-a0d8-d1314256a486/592d7b97f3e21a46c19317b406834e6593e391a0a8669eb0575612db138886dc",
    "payout": {
      "status": "pending",
      "gateway_id": 3559,
      "message": "Transaction was initialized.",
      "bank_code": "0001"
    },
    "imps": {
      "type": "imps"
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "message": "Transaction was initialized.",
    "test": false,
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe",
      "phone": "123789105"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }
  }
}

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

Выплата

Процесс выплаты

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

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

Параметр Тип данных Описание
request object
amount * обязательный
 bigInteger Сумма транзакции, должна быть целым числом в минимальных денежных единицах, например, 50000 (500 рупий). Последние цифры значения параметра должны быть 00.
method object Секция параметров способа выплаты.
type * обязательный
 string imps
account_number * обязательный
 string Номер банковского счета получателя выплаты.
ifsc_code * обязательный
 string IFSC-код банка получателя.
customer object Секция информации о покупателе.
first_name * обязательный
 string Имя покупателя.
last_name * обязательный
 string Фамилия покупателя.
phone string (10) Номер телефона покупателя. Должен состоять из 10 цифр.
Пример запроса 
{
  "request": {
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "test": false,
    "customer": {
      "first_name": "John",
      "last_name": "Doe"
    },
    "method": {
      "type": "imps",
      "ifsc_code": "ICIC0000739",
      "account_number": "947889674934"
    }
  }
}
Ответ

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

Пример ответа 
{
  "transaction": {
    "uid": "65358109-b585-481f-849e-65db68168a89",
    "type": "payout",
    "status": "pending",
    "amount": 20000,
    "currency": "INR",
    "description": "description",
    "created_at": "2023-12-27T10:59:11Z",
    "updated_at": "2023-12-27T10:59:15Z",
    "manually_corrected_at": null,
    "method_type": "imps",
    "receipt_url": "https://my.constantpos.com/customer/transactions/65358109-b585-481f-849e-65db68168a89/f47f5172243d59afa5278f5222bd565d1b7d0514f455ed720a12a73fb9198fc4",
    "payout": {
      "status": "pending",
      "gateway_id": 3564,
      "ref_id": "LQNNYJTC0DIDP9W7CIF0YG59LUXF40P",
      "message": "Transaction was initialized.",
      "bank_code": "200"
    },
    "imps": {
      "type": "imps"
    },
    "customer": {
      "email": null,
      "ip": null
    },
    "message": "Transaction was initialized.",
    "test": false,
    "billing_address": {
      "first_name": "John",
      "last_name": "Doe"
    },
    "additional_data": {
      "payment_method": {
        "type": "alternative"
      }
    }
  }
}