Перейти к основному содержимому

Методы

При обработке запросов проверяются корректность переданных данных, наличие обязательных заголовков, а также права пользователя на выполнение действий.

к сведению

В документации указано, какие параметры являются обязательными для каждой операции. Но их необязательно передавать в теле этого конкретного запроса — их можно передать заранее при создании сессии.

Пример отправки запроса на выплату:

  • Если запрос session/create передан пустым, запрос начала выплаты (session/start/payout) должен содержать все обязательные параметры.
  • Если запрос session/create содержит все обязательные параметры, указанные для операции, запрос начала выплаты (session/start/payout) может быть пустым или содержать только те параметры, значение которых вы хотите изменить.
  • Если запрос session/create содержит только некоторые обязательные параметры, запрос начала выплаты (session/start/payout) должен содержать те обязательные параметры, которые не были переданы ранее.
  • При создании сессии и выплаты одновременно (session/init/payout) все необходимые параметры должны быть переданы сразу.

Проведение операций​

recurrent/disable​

Отключение токена​

Метод отключает токен для рекуррентных платежей. Для этого отправьте токен в запросе. В ответе вы получите параметр is_active: false, это значит, что с этим токеном больше нельзя проводить рекуррентные платежи.

После отключения токена в параметре finished_at может отображаться дата, относящаяся к 2000 году. Проигнорируйте это значение.

Адрес для отправки запроса​

/api/v1/recurrent/disable

Параметры запроса​

НазваниеОбязательностьТипОписание
recurrent+objectТокен
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/recurrent/disable \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"recurrent": {
"token": "9a1c4e7f2b8d5036af61c9e0d4b72f8a3c5e190d6f24b8a7c0e3d5f19b6a2c48"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
recurrent+objectТокен
Пример ответа
{
"recurrent": {
"token": "9a1c4e7f2b8d5036af61c9e0d4b72f8a3c5e190d6f24b8a7c0e3d5f19b6a2c48",
"created_at": "2025-07-14T13:17:11+03:00",
"finished_at": "2025-07-31T16:05:42+03:00",
"is_active": false,
"type": "recurrent_token"
},
"status": "ok"
}

session/cancel​

Отмена операции​

Метод для отмены выплаты или платежа после получения вебхука ready_to_confirm или ready_to_capture от Банка 131.

Адрес для отправки запроса​

/api/v1/session/cancel

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор сессии
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/cancel \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"payments": [{
"id": "po_2025",
"status": "pending",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "card",
"card": {
"last4": "2058",
"brand": "mir"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"metadata": "good"
}]
}
}

session/capture​

Списание захолдированной суммы​

Метод для списания ранее захолдированных средств после получения вебхука ready_to_capture от Банка 131. Вы можете списать как полную сумму, так и ее часть.

Адрес для отправки запроса​

/api/v1/session/capture

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор сессии
amount_details-objectСумма. Может быть меньше захолдированной, но обязательно больше 0. Если параметр отсутствует, захолдированная сумма будет списана полностью
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/capture \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2024-05-27T02:03:00.000000Z",
"updated_at": "2024-05-27T02:03:00.000000Z",
"acquiring_payments": [{
"id": "pm_1313",
"status": "succeeded",
"created_at": "2024-05-27T02:03:00.000000Z",
"finished_at": "2024-05-27T02:03:00.000000Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"refunds": [{
"id": "rf_23",
"status": "in_progress",
"created_at": "2024-05-27T02:03:00.000000Z",
"amount_details": {
"amount": 10000,
"currency": "rub"
}
}]
}]
}
}

session/confirm​

Подтверждение операции​

Метод для подтверждения выплаты или платежа после получения вебхука ready_to_confirm или ready_to_capture от Банка 131. Запрос нужно отправить в течение 4 часов с момента создания операции, иначе вернется ошибка confirm_timeout.

Адрес для отправки запроса​

/api/v1/session/confirm

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор сессии
confirm_information- (обязателен при операциях с расчетным и номинальным счетами, а также при денежных переводах)objectИнформация для подтверждения операции
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/confirm \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"payments": [{
"id": "po_2025",
"status": "pending",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "card",
"card": {
"last4": "2058",
"brand": "mir"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"metadata": "good"
}]
}
}

session/create​

Создание платежной сессии​

Метод для создания платежной сессии. Возвращает session_id — идентификатор сессии, по которому Банк 131 определяет, к какой сессии относится запрос.

Этот метод обязателен при платежах через виджет, так как для генерации публичного токена нужен session_id. Токен связывает данные карты, введенные пользователем, с конкретной сессией. Без этого Банк 131 не сможет определить, к какому платежу относятся введенные данные и вебхуки.

Если вы принимаете платеж через СБП, обязательно передайте faster_payment_system в payment_details.

Вы можете создать сессию и начать выплату/платеж одновременно с помощью метода session/init. Не рекомендуем использовать этот способ.

Адрес для отправки запроса​

/api/v1/session/create

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_method-objectПлатежные данные для зачисления средств
payment_details-objectПлатежные данные для списания средств
amount_details-objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details-objectИнформация об отправителе и получателе
customer-objectДанные пользователя в вашей системе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/create \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"metadata": "order123"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "created",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z"
}
}

session/init/payment​

Создание сессии с одновременным началом платежа​

Метод для проведения платежа без отдельного создания сессии. В этом случае вы передаете все данные сразу.

В ответе возвращаются параметры созданной сессии с информацией о платеже (acquiring_payments/payment_list).

Адрес для отправки запроса​

/api/v1/session/init/payment

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_details+objectПлатежные данные для списания средств
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
customer+objectДанные плательщика в вашей системе
payment_options-objectДополнительные параметры платежа
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/init/payment \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_details": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058",
"expiration_month": "05",
"expiration_year": "35",
"security_code": "123"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"customer": {
"reference": "lucky"
},
"payment_options": {
"return_url": "https://131.ru"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"acquiring_payments": [{
"id": "pm_203",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"payment_options": {
"return_url": "https://131.ru"
}
}]
}
}

session/init/payment/sync​

Не рекомендуем использовать этот метод.

Метод для платежа одним запросом. Подходит, если вы не используете виджет.

При использовании этого метода вебхуки не отправляются. Результат платежа возвращается в ответе на этот же запрос.

Подробнее о платеже одним запросом >

Адрес для отправки запроса​

/api/v1/session/init/payment/sync

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_details+objectПлатежные данные для списания средств
  type+stringТип способа оплаты. Значение: card
  card+objectДанные банковской карты
    type+stringСпособ передачи данных карты. Значение: bank_card
    bank_card+objectДанные карты в открытом виде
      number+stringНомер карты
      expiration_month+stringМесяц, до которого действует карта, в формате ММ. Например 01
      expiration_year+stringГод, до которого действует карта, в формате ГГ. Например 35
      security_code+stringСекретный код CVC или CVV
amount_details+objectСумма
  amount+intЗначение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
  currency+stringКод валюты согласно ISO 4217. Регистр не важен. Пример: rub
customer+objectДанные плательщика в вашей системе
  reference+stringИдентификатор плательщика в вашей системе
payment_options+objectДополнительные параметры платежа
  return_url+stringВалидный URL для перенаправления пользователя после оплаты
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/init/payment/sync \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_details": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058",
"expiration_month": "01",
"expiration_year": "35",
"security_code": "123"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"customer": {
"reference": "lucky"
},
"payment_options": {
"return_url": "https://131.ru"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "accepted",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"acquiring_payments": [{
"id": "pm_203",
"status": "succeeded",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"payment_options": {
"return_url": "https://131.ru"
}
}]
}
}

session/init/payout​

Создание сессии с одновременным началом выплаты​

Метод для проведения выплаты без отдельного создания сессии. В этом случае вы передаете все данные сразу.

В ответе возвращаются параметры созданной сессии и информация о выплате (payments/payout_list).

Адрес для отправки запроса​

/api/v1/session/init/payout

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_method+objectПлатежные данные для зачисления средств
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details- (обязателен для выплат на карты)objectИнформация об отправителе и получателе
customer-objectДанные получателя в вашей системе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/init/payout \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_method": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058"
}
}
},
"amount_details": {
"amount": 1000,
"currency": "rub"
},
"participant_details": {
"recipient": {
"full_name": "Иванов Иван Иванович"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"payments": [{
"id": "po_2025",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "card",
"card": {
"last4": "2058",
"brand": "mir"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"recipient": {
"full_name": "Иванов Иван Иванович"
}
},
"metadata": "good"
}]
}
}

session/refund​

Возврат платежа​

Метод для возврата денег отправителю. Можно вернуть всю сумму платежа или ее часть, при этом комиссия не возвращается. Отменить возврат нельзя — перед отправкой запроса убедитесь, что это действительно необходимо.

После возврата Банк 131 отправит вам вебхук payment_refunded с результатом.

Адрес для отправки запроса​

/api/v1/session/refund

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор сессии из платежа, который нужно вернуть
amount_details-objectСумма. Если не указать, отправителю вернется вся сумма платежа
metadata-*Дополнительная информация
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/refund \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"acquiring_payments": [{
"id": "pm_2705",
"status": "succeeded",
"created_at": "2025-05-27T02:03:00.000000Z",
"finished_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"refunds": [{
"id": "rf_23",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"amount_details": {
"amount": 10000,
"currency": "rub"
}
}]
}]
}
}

session/start/payment​

Начало платежа​

Метод для начала платежа в рамках уже созданной сессии. В запросе можно передать недостающие параметры или заменить уже переданные.

Адрес для отправки запроса​

/api/v1/session/start/payment

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии
payment_details-objectПлатежные данные для списания средств
amount_details-objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
customer-objectДанные плательщика в вашей системе
payment_options-objectДополнительные параметры
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/start/payment \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230",
"payment_details": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058",
"expiration_month": "01",
"expiration_year": "35",
"security_code": "123"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"customer": {
"reference": "lucky"
},
"payment_options": {
"return_url": "https://www.131.ru"
},
"metadata": "good"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2024-08-21T06:21:36.913863Z",
"updated_at": "2024-08-21T06:21:56.832509Z",
"acquiring_payments": [{
"id": "pm_3232",
"status": "in_progress",
"created_at": "2024-08-21T06:21:56.846204Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "card",
"card": {
"last4": "2058",
"brand": "mir",
"country_iso3": "RUS"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"payment_options": {
"return_url": "https://www.131.ru"
},
"metadata": "good"
}]
}
}

session/start/payout​

Начало выплаты​

Метод для начала выплаты в рамках уже созданной сессии. В запросе можно передать недостающие параметры или заменить уже переданные.

Адрес для отправки запроса​

/api/v1/session/start/payout

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии
payment_method-objectПлатежные данные для зачисления средств
amount_details-objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details- (обязателен для выплат на карты)objectИнформация об отправителе и получателе
customer-objectДанные получателя в вашей системе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/start/payout \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230",
"participant_details": {
"recipient": {
"full_name": "Иванов Иван Иванович"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"payments": [{
"id": "po_2025",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "card",
"card": {
"last4": "2058",
"brand": "mir"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"recipient": {
"full_name": "Иванов Иван Иванович"
}
},
"metadata": "good"
}]
}
}

token​

Получение публичного токена для виджетов​

Для работы с виджетами нужен публичный токен. Он действует 24 часа и предназначен для одной операции.

В запросе укажите тип виджета, токен для которого нужно получить.

Адрес для отправки запроса​

/api/v1/token

Параметры запроса​

НазваниеОбязательностьТипОписание
tokenize_widget-objectДанные для виджета токенизации
acquiring_widget-objectДанные для виджета платежной формы
sber_pay_widget-objectДанные для виджета SberPay
Пример запроса токена для выплаты с получением данных карты через виджет
curl -X POST \
https://demo.bank131.ru/api/v1/token \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"tokenize_widget": {
"access": true
}
}'
Пример запроса токена для платежа с оплатой через платежную форму
curl -X POST \
https://demo.bank131.ru/api/v1/token \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"acquiring_widget": {
"session_id": "ps_123456"
}
}'
Пример запроса токена для оплаты через SberPay
curl -X POST \
https://demo.bank131.ru/api/v1/token \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"sber_pay_widget": {
"session_id": "ps_77872830",
"phone": "79680000000",
"return_url": "https://131.ru"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
public_token-stringПубличный токен
error-objectОшибка
Примеры ответов
{
"status": "ok",
"public_token": "e065c2f1328e74156a883c00e210a4b1b1451782bbfdd18ae8d05715e05d8539"
}

tokenize​

Токенизация банковского счета​

Метод для получения токена банковского счета получателя выплаты. В ответе также возвращается маскированный номер счета. Токен не имеет срока действия.

Если счет не проходит проверку на соответствие разрешенному списку счетов, возвращается ошибка «Введите другой номер счета».

Адрес для отправки запроса​

/api/v1/tokenize

Параметры запроса​

ПараметрТипОписание
typestringТип банковского счета
bank_account_ruobjectДополнительная информация о банковском счете
  bikstringБИК банка
  accountstringНомер счета
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/tokenize \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"type": "bank_account_ru",
"bank_account_ru": {
"bik": "044525974",
"account": "40817810400003869535"
}
}'

Параметры ответа​

ПараметрТипОписание
statusstringТип банковского счета
tokenstringТокен
dataobjectДанные маскированного счета
errorobjectОшибка
Примеры ответов
{
"status": "ok",
"token": "d47b2f90a6c1e8350f9a4d7c2e6b183fa5c0d9e472b6f8a1c3e5d7092b4f6a8c",
"data": {
"masked_account": "40817***9535"
}
}

tokenize/elements​

Токенизация номера банковской карты​

Метод для получения токена номера банковской карты получателя выплаты. В результате номер карты сохраняется в системе Банка 131. В ответе возвращается токен для многократных выплат на эту карту. Срок действия токена не ограничен.

Чтобы использовать метод, обратитесь к персональному менеджеру в Банке 131.

Адрес для отправки запроса​

/api/v1/tokenize/elements

Параметры запроса​

НазваниеОбязательностьТипОписание
card_elements+objectНомер банковской карты для токенизации
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/tokenize/elements \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"card_elements": [
{
"ref": "number",
"type": "card_number",
"card_number": "2200774546102058"
}
]
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
data+objectДанные карты
error-objectОшибка
Примеры ответов
{
"status": "ok",
"data": {
"number": {
"token": "9a1c4e7f2b8d5036af61c9e0d4b72f8a3c5e190d6f24b8a7c0e3d5f19b6a2c48",
"info": {
"masked_card_number": "220077******2058",
"card_network": "mir",
"card_type": "mir"
}
}
}
}

Информация​

fps/banks​

Получение списка банков — участников СБП​

Метод для получения списка банков с их наименованиями и идентификаторами для отправки выплат через Систему быстрых платежей.

Адрес для отправки запроса​

/api/v1/fps/banks

Пример запроса
curl -X GET \
https://demo.bank131.ru/api/v1/fps/banks \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{}'
Пример ответа
{
"banks": [{
"id": "100000000243",
"eng_name": "National Standard Bank",
"ru_name": "Национальный стандарт"
},
{
"id": "100000000056",
"eng_name": "Khlynov",
"ru_name": "Хлынов"
},...]
}

report/account_balance​

Проверка баланса​

Метод для получения текущего остатка по расчетному или номинальному счету.

Адрес для отправки запроса​

/api/v1/report/account_balance

Параметры запроса​

НазваниеОбязательностьТипОписание
account_number+stringНомер счета. Счет должен начинаться с цифр: 40702, 40703, 40802, 40807, 40701
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/report/account_balance \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"account_number": "40702810400000000333"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
account_number-stringНомер счета
account_currency-stringВалюта счета согласно ISO 4217 (например, RUB)
balance-objectИнформация о балансе
error-objectОшибка
Примеры ответов
{
"status": "ok",
"account_number": "40702810400000000333",
"account_currency": "RUB",
"balance": {
"current_balance": 20900
}
}

report/account_statement​

Получение выписки​

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

Адрес для отправки запроса​

/api/v1/report/account_statement

Параметры запроса​

НазваниеОбязательностьТипОписание
account_number+stringНомер счета (20 цифр), по которому запрашивается выписка
date_from+dateДата начала выписки. Пример: 2023-06-01
date_to+dateДата окончания выписки. Пример: 2023-06-01. Значения в date_from и date_to должны совпадать
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/report/account_statement \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"date_from": "2023-06-01",
"date_to": "2023-06-01",
"account_number": "40702810600200000014"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
method+objectИнформация о методе
  name+stringНазвание метода account_statement
  account_statement+objectДетали выписки
    date_from+dateДата начала выписки
    date_to+dateДата окончания выписки
    account_number+stringНомер счета (20 цифр), по которому сформирована выписка
    total_turnover+objectИнформация по движению средств
      debet+intСумма списаний по счету за период выписки
      credit+intСумма пополнений по счету за период выписки
    total_balance+objectИнформация по балансу
      opening+intВходящий остаток по счету на дату начала выписки
      closing+intИсходящий остаток по счету на дату окончания выписки
    transactions+arrayСписок операций
      amount+intСумма операций (только неотрицательные значения)
      base_amount-intСумма операции в валюте (заполняется для валют, отличных от RUB)
      currency+stringВалюта операции
      payment_date+dateДата операции
      bank_system_id+stringИдентификатор платежа. Указывается для любого движения денежных средств по счету:
- для платежей, отправленных по API
- для переводов из другого банка
- для платежей, совершенных через интернет-банк
      transaction_id-stringИдентификатор операции (для платежей через API)
      session_id-stringИдентификатор сессии (для платежей через API)
      purpose+stringНазначение платежа
      counter_party+objectИнформация о контрагенте
        kpp-stringКПП контрагента
        inn-stringИНН контрагента
        name+stringНаименование контрагента
        account_number+stringНомер счета контрагента
        bank_code+stringБИК банка контрагента
      type+stringТип транзакции. Может принимать значения credit (для операции пополнения) или debet (для операции списания)
Пример успешного ответа
{
"status": "ok",
"method": {
"name": "account_statement",
"account_statement": {
"date_from": "2022-11-12T18:19:32.487+0000",
"date_to": "2022-11-13T18:19:32.487+0000",
"account_number": "40703810500000000025",
"total_turnover": {
"debet": 0,
"debet_base": null,
"credit": 100,
"credit_base": null
},
"total_balance": {
"opening": 0,
"opening_base": null,
"closing": 100,
"closing_base": null
},
"transactions": [{
"amount": 10000,
"base_amount": null,
"currency": "RUB",
"payment_date": "2022-11-13",
"bank_system_id": "2080040097819020",
"transaction_id": "c7b923ec-844f-4d98-ad02-795d62fe1989",
"session_id": "ps_3230",
"purpose": "Пополнение счета для тестов",
"counter_party": {
"kpp": "165501001",
"inn": "1655415696",
"name": "Плата за услуги процессинга по переводам без открытия счета",
"account_number": "70606810600004710401",
"bank_code": "049205131"
},
"type": "credit"
}]
}
}
}
Примеры неуспешных ответов

date_from не равна date_to

{
"status": "error",
"error": {
"description": "Invalid input request parameters: (max interval is 1 day)",
"code": "invalid_request"
}
}

date_from больше date_to

{
"status": "error",
"error": {
"description": "Invalid input request parameters: (date_to must be greater than date_from); (max interval is 1 day)",
"code": "invalid_request"
}
}

Невалидная дата в date_from

{
"status": "error",
"error": {
"description": "Invalid value in date_from",
"code": "invalid_request"
}
}

Невалидная дата в date_to

{
"status": "error",
"error": {
"description": "Invalid value in date_to",
"code": "invalid_request"
}
}

session/status​

Получение информации о сессии​

Метод для получения полной информации о платежной сессии. Например, вы можете проверить статус выплаты или узнать, можно ли списать захолдированную сумму.

Адрес для отправки запроса​

/api/v1/session/status

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/status \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"next_action": "confirm",
"payments": [{
"id": "po_2025",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "card",
"card": {
"last4": "2058",
"brand": "mir",
"bin": "220077"
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"transaction_info": {
"rrn": "425307614918",
"auth_code": "057441"
},
"metadata": "good"
}]
}
}

token/info​

Получение информации о токене​

Метод для получения информации о токене: как о привязанном средстве оплаты, так и о его технических параметрах.

С помощью запроса вы можете получить следующую информацию:

  • по карте — маскированный номер и тип платежной системы;
  • по счету — маскированный номер счета;
  • по самому токену — тип, дата и время создания, срок действия и активен ли он на момент запроса.

Адрес для отправки запроса​

/api/v1/token/info

Параметры запроса​

НазваниеОбязательностьТипОписание
type+stringТип токена, по которому нужна информация. Значения: card, public_token, recurrent_token, bank_account_ru
card- (обязателен для type = card)objectДанные банковской карты
public_token- (обязателен для type = public_token)objectДанные публичного токена виджета
recurrent_token- (обязателен для type = recurrent_token)objectДанные токена для рекуррентных платежей и выплат
bank_account_ru- (обязателен для type = bank_account_ru)objectДанные банковского счета
Примеры запросов информации

Вы отправляете хеш-номер банковской карты и получаете информацию по карте.

curl -X POST \
https://demo.bank131.ru/api/v1/token/info \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"type": "card",
"card": {
"type": "encrypted_card",
"encrypted_card": {
"number_hash": "9a1c4e7f2b8d5036af61c9e0d4b72f8a3c5e190d6f24b8a7c0e3d5f19b6a2c48"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
info-objectИнформация о токене, зависит от типа запроса (type): токенизированная банковская карта, публичный токен, токен для рекуррентных платежей или выплат или токен банковского счета
error-objectОшибка
Примеры ответов
{
"status": "ok",
"info": {
"number_hash": "9a1c4e7f2b8d5036af61c9e0d4b72f8a3c5e190d6f24b8a7c0e3d5f19b6a2c48",
"brand": "mir",
"last4": "2058",
"type": "card"
}
}

wallet/balance​

Проверка баланса​

Метод для получения текущего остатка по обеспечительному счету. Используйте его, чтобы убедиться, что на обеспечительном счете достаточно средств для выплат и возвратов. Если денег недостаточно — пополните счет.

примечание

Баланс по эквайрингу можно узнать в вашем аккаунте интернет-банка в разделе Выписки.

Адрес для отправки запроса​

/api/v1/wallet/balance

Параметры запроса​

НазваниеОбязательностьТипОписание
request_datetime+stringДата и время отправки запроса согласно ISO 8601
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/wallet/balance \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"request_datetime": "2025-10-14T19:53:00+03:00"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
wallets-objectСписок доступных депозитов в Банке 131
error-objectОшибка
Примеры ответов
{
"status": "ok",
"wallets": [{
"id": "131",
"amount_details": {
"amount": 13100,
"currency": "rub"
}
}]
}

Номинальный счет​

session/create/nominal​

Создание платежной сессии​

Метод создания платежной сессии для выплаты на банковский счет. Возвращает session_id — идентификатор сессии, по которому Банк 131 определяет, к какой сессии относится запрос.

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

Вы можете создать сессию и начать выплату одновременно с помощью метода session/init/payout/nominal. Не рекомендуем использовать этот способ.

Адрес для отправки запроса​

/api/v1/session/create/nominal

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_method-objectПлатежные данные для зачисления средств
amount_details-objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details-objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/create/nominal \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_method": {
"type": "bank_account",
"bank_account": {
"ru": {
"bik": "044525974",
"account": "40817810400003869535",
"full_name": "Иванов Иван Иванович",
"description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается"
},
"system_type": "ru"
}
},
"amount_details": {
"amount": 300,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810300200000013"
},
"recipient": {
"beneficiary_id": "1234567890"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_12345",
"status": "in_progress",
"created_at": "2023-05-10T16:58:43.586072Z",
"updated_at": "2023-05-10T16:58:43.705620Z",
"payments": [{
"id": "po_72265",
"status": "in_progress",
"created_at": "2023-05-10T16:58:43.781934Z",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810900000000001",
"full_name": "Наименование организации",
"description": "Перечисление денежных средств по договору № 1 НС от 01.09.2021 комиссия площадки за декабрь 2022 г. НДС не облагается.",
"is_fast": false,
"kpp": "156605001",
"inn": "3111104710"
}
}
},
"amount_details": {
"amount": 300,
"currency": "rub"
},
"paymentMetadata": {},
"participant_details": {
"sender": {
"account": "40702810300200000013"
},
"recipient": {
"beneficiary_id": "1234567890"
}
}
}]
}
}

session/init/payout/nominal​

Создание сессии с одновременным началом выплаты на банковский счет​

Метод для проведения выплаты на банковский счет, в том числе через СБП, без отдельного создания сессии. В этом случае вы передаете все данные сразу.

Адрес для отправки запроса​

/api/v1/session/init/payout/nominal

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_method+objectПлатежные данные для зачисления средств
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details+objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Примеры запросов
curl -X POST \
https://demo.bank131.ru/api/v1/session/init/payout/nominal \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
// для выплаты через СБП используйте объект faster_payment_system
"ru": {
"bik": "044525974",
"account": "40817810400003869535",
"full_name": "Иванов Иван Иванович",
"description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается"
}
}
},
"amount_details": {
"amount": 300,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810300200000013"
},
"recipient": {
"beneficiary_id": "1234567890"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_12345",
"status": "in_progress",
"created_at": "2023-05-10T16:58:43.586072Z",
"updated_at": "2023-05-10T16:58:43.705620Z",
"payments": [{
"id": "po_72265",
"status": "in_progress",
"created_at": "2023-05-10T16:58:43.781934Z",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810900000000001",
"full_name": "Наименование организации",
"description": "Перечисление денежных средств по договору № 1 НС от 01.09.2021 комиссия площадки за декабрь 2022 г. НДС не облагается.",
"is_fast": false,
"kpp": "156605001",
"inn": "3111104710"
}
}
},
"amount_details": {
"amount": 300,
"currency": "rub"
},
"paymentMetadata": {},
"participant_details": {
"sender": {
"account": "40702810300200000013"
},
"recipient": {
"beneficiary_id": "1234567890"
}
}
}]
}
}

session/multi/create/nominal​

Создание платежной сессии​

Метод создания платежной сессии для выплаты на карту. Возвращает session_id — идентификатор сессии, по которому Банк 131 определяет, к какой сессии относится запрос.

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

Вы можете создать сессию и начать выплату одновременно с помощью метода session/multi/init/payment/nominal. Не рекомендуем использовать этот способ.

Адрес для отправки запроса​

/api/v1/session/multi/create/nominal

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_details-objectПлатежные данные для списания средств
payment_method-objectПлатежные данные для зачисления средств
participant_details-objectИнформация об отправителе и получателе
amount_details-objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
customer-objectДанные получателя в вашей системе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/multi/create/nominal \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_nominal_account",
"transfer_from_nominal_account": {
"description": "Назначение платежа"
}
}
},
"payment_method": {
"type": "card",
"card": {
"type": "mir",
"bank_card": {
"number": "2200774546102058"
}
}
},
"participant_details": {
"sender": {
"full_name": "Данные отправителя",
"beneficiary_id": "1987654321"
},
"recipient": {
"full_name": "Иванов Иван Иванович",
"beneficiary_id": "1234567890",
"reference": "1234"
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"customer": {
"reference": "lucky"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_12345",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.274416Z",
"updated_at": "2021-08-06T11:34:51.466550Z",
"payments": [{
"id": "po_25657",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545329Z",
"customer": {
"reference": "lucky"
},
"payment_method": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Данные отправителя",
"beneficiary_id": "1987654321"
},
"recipient": {
"full_name": "Иванов Иван Иванович",
"beneficiary_id": "1234567890",
"reference": "1234"
}
}
}],
"acquiring_payments": [{
"id": "pm_15174",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545232Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_nominal_account",
"transfer_from_nominal_account": {
"description": "test payout",
"card_mask": "220077******2058"
}
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"metadata": {
"participant_details": {
"sender": {
"full_name": "Данные отправителя",
"beneficiary_id": "1987654321"
},
"recipient": {
"full_name": "Иванов Иван Иванович",
"beneficiary_id": "1234567890",
"reference": "1234"
}
}
}
}
}]
}
}

session/multi/init/payment/nominal​

Создание сессии с одновременным началом выплаты на банковскую карту​

Метод для проведения выплаты на банковскую карту без отдельного создания сессии. В этом случае вы передаете все данные сразу.

Адрес для отправки запроса​

/api/v1/session/multi/init/payment/nominal

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_details+objectПлатежные данные для списания средств
payment_method+objectПлатежные данные для зачисления средств
participant_details+objectИнформация об отправителе и получателе
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
customer+objectДанные получателя в вашей системе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/multi/init/payment/nominal \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_nominal_account",
"transfer_from_nominal_account": {
"description": "test payout"
}
}
},
"payment_method": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058"
}
}
},
"participant_details": {
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"beneficiary_id": "123412341234"
},
"sender": {
"full_name": "Ivan Ivanovich Ivanov",
"beneficiary_id": "123412341234"
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"customer": {
"reference": "lucky"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_12345",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.274416Z",
"updated_at": "2021-08-06T11:34:51.466550Z",
"payments": [{
"id": "po_25657",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545329Z",
"customer": {
"reference": "lucky"
},
"payment_method": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}],
"acquiring_payments": [{
"id": "pm_15174",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545232Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_nominal_account",
"transfer_from_nominal_account": {
"description": "test payout",
"card_mask": "400000******0002"
}
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}]
}
}

session/multi/start/payment/nominal​

Начало выплаты на банковскую карту​

Метод для начала выплаты в рамках уже созданной сессии. В запросе можно передать недостающие параметры или заменить уже переданные.

Адрес для отправки запроса​

/api/v1/session/multi/start/payment/nominal

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии
payment_details+objectПлатежные данные для списания средств
payment_method+objectПлатежные данные для зачисления средств
participant_details+objectИнформация об отправителе и получателе
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
customer+objectДанные получателя в вашей системе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/multi/start/payment/nominal \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_12345",
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_nominal_account",
"transfer_from_nominal_account": {
"description": "test payout"
}
}
},
"payment_method": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058"
}
}
},
"participant_details": {
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"beneficiary_id": "123412341234"
},
"sender": {
"full_name": "Ivan Ivanovich Ivanov",
"beneficiary_id": "123412341234"
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"customer": {
"reference": "test"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_72974",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.274416Z",
"updated_at": "2021-08-06T11:34:51.466550Z",
"payments": [{
"id": "po_25657",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545329Z",
"customer": {
"reference": "lucky"
},
"payment_method": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}],
"acquiring_payments": [{
"id": "pm_15174",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545232Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_nominal_account",
"transfer_from_nominal_account": {
"description": "test payout",
"card_mask": "400000******0002"
}
}
},
"amount_details": {
"amount": 30000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}]
}
}

session/start/payout/nominal​

Начало выплаты на банковский счет​

Метод для начала выплаты на банковский счет, в том числе через СБП, в рамках уже созданной сессии. В запросе можно передать недостающие параметры или заменить уже переданные.

Адрес для отправки запроса​

/api/v1/session/start/payout/nominal

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии
payment_method+objectПлатежные данные для зачисления средств
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details+objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Примеры запросов
curl -X POST \
https://demo.bank131.ru/api/v1/session/start/payout/nominal \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_12345",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
// для выплаты через СБП используйте объект faster_payment_system
"ru": {
"bik": "044525974",
"account": "40817810400003869535",
"full_name": "Иванов Иван Иванович",
"description": "Перевод средств по договору № 5015553111 Иванов Иван Иванович НДС не облагается"
}
}
},
"amount_details": {
"amount": 30000,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810300200000013"
},
"recipient": {
"beneficiary_id": "1234567890"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_12345",
"status": "in_progress",
"created_at": "2023-05-10T16:58:43.586072Z",
"updated_at": "2023-05-10T16:58:43.705620Z",
"payments": [{
"id": "po_72265",
"status": "in_progress",
"created_at": "2023-05-10T16:58:43.781934Z",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810900000000001",
"full_name": "Наименование организации",
"description": "Перечисление денежных средств по договору № 1 НС от 01.09.2021 комиссия площадки за декабрь 2022 г. НДС не облагается.",
"is_fast": false,
"kpp": "156605001",
"inn": "3111104710"
}
}
},
"amount_details": {
"amount": 30000,
"currency": "rub"
},
"paymentMetadata": {},
"participant_details": {
"sender": {
"account": "40702810300200000013"
},
"recipient": {
"beneficiary_id": "1234567890"
}
}
}]
}
}

Расчетный счет​

session/create/rko​

Создание платежной сессии​

Метод создания платежной сессии для выплаты на банковский счет. Возвращает session_id — идентификатор сессии, по которому Банк 131 определяет, к какой сессии относится запрос.

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

Вы можете создать сессию и начать выплату одновременно с помощью метода session/init. Не рекомендуем использовать этот способ.

Адрес для отправки запроса​

/api/v1/session/create/rko

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_method-objectПлатежные данные для зачисления средств
amount_details-objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details-objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/create/rko \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810300000000006",
"full_name": "Вектор",
"inn": "1234567890",
"kpp": "165801002",
"description": "Перевод с расчетного счета на счет другого ЮЛ, открытого в Банке 131"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810900000000011"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"payments": [{
"id": "po_2025",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810300000000006",
"full_name": "Вектор",
"inn": "1234567890",
"kpp": "165801002",
"description": "Перевод с расчетного счета на счет другого ЮЛ, открытого в Банке 131"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810900000000011"
}
},
"metadata": "good"
}]
}
}

session/init/payout/rko​

Создание сессии с одновременным началом выплаты на банковский счет​

Метод для проведения выплаты на банковский счет, в том числе через СБП, без отдельного создания сессии. В этом случае вы передаете все данные сразу.

Адрес для отправки запроса​

/api/v1/session/init/payout/rko

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_method+objectПлатежные данные для зачисления средств
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details+objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/init/payout/rko \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810300000000006",
"full_name": "Вектор",
"inn": "1234567890",
"kpp": "165801002",
"description": "Перевод с расчетного счета на счет другого ЮЛ, открытого в Банке 131"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810900000000011"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"payments": [{
"id": "po_2025",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810300000000006",
"full_name": "Вектор",
"inn": "1234567890",
"kpp": "165801002",
"description": "Перевод с расчетного счета на счет другого ЮЛ, открытого в Банке 131"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810900000000011"
}
},
"metadata": "good"
}]
}
}

session/multi/create/rko​

Создание платежной сессии​

Метод создания платежной сессии для выплаты на банковскую карту. Возвращает session_id — идентификатор сессии, по которому Банк 131 определяет, к какой сессии относится запрос.

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

Вы можете создать сессию и начать выплату одновременно с помощью метода session/init. Не рекомендуем использовать этот способ.

Адрес для отправки запроса​

/api/v1/session/multi/create/rko

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_details-objectПлатежные данные для списания средств
payment_method-objectПлатежные данные для зачисления средств
participant_details-objectИнформация об отправителе и получателе
amount_details-objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
customer-objectДанные получателя в вашей системе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/multi/create/rko \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_bank_account",
"transfer_from_bank_account": {
"description": "Назначение платежа"
}
}
},
"payment_method": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "****************"
}
}
},
"participant_details": {
"sender": {
"full_name": "Данные отправителя"
},
"recipient": {
"full_name": "Иванов Иван Иванович"
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"customer": {
"reference": "123456789012"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_12345",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.274416Z",
"updated_at": "2021-08-06T11:34:51.466550Z",
"payments": [{
"id": "po_25657",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545329Z",
"customer": {
"reference": "lucky"
},
"payment_method": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}],
"acquiring_payments": [{
"id": "pm_15174",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545232Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_bank_account",
"transfer_from_bank_account": {
"description": "test payout",
"card_mask": "400000******0002"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}]
}
}

session/multi/init/payment/rko​

Создание сессии с одновременным началом выплаты на банковскую карту​

Метод для проведения выплаты на банковскую карту без отдельного создания сессии. В этом случае вы передаете все данные сразу.

Адрес для отправки запроса​

/api/v1/session/multi/init/payment/rko

Параметры запроса​

НазваниеОбязательностьТипОписание
payment_details+objectПлатежные данные для списания средств
payment_method+objectПлатежные данные для зачисления средств
customer+objectДанные получателя в вашей системе
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details+objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/multi/init/payment/rko \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_bank_account",
"transfer_from_bank_account": {
"description": "test payout"
}
}
},
"payment_method": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058"
}
}
},
"participant_details": {
"recipient": {
"full_name": "Ivan Ivanovich Ivanov"
},
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"customer": {
"reference": "test"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.274416Z",
"updated_at": "2021-08-06T11:34:51.466550Z",
"payments": [{
"id": "po_25657",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545329Z",
"customer": {
"reference": "lucky"
},
"payment_method": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}],
"acquiring_payments": [{
"id": "pm_15174",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545232Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_bank_account",
"transfer_from_bank_account": {
"description": "test payout",
"card_mask": "400000******0002"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}]
}
}

session/multi/start/payment/rko​

Начало выплаты на банковскую карту​

Метод для начала выплаты в рамках уже созданной сессии. В запросе можно передать недостающие параметры или заменить уже переданные.

Адрес для отправки запроса​

/api/v1/session/multi/start/payment/rko

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии
payment_details+objectПлатежные данные для списания средств
payment_method+objectПлатежные данные для зачисления средств
customer+objectДанные получателя в вашей системе
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details+objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/multi/start/payment/rko \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_12345",
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_bank_account",
"transfer_from_bank_account": {
"description": "test payout"
}
}
},
"payment_method": {
"type": "card",
"card": {
"type": "bank_card",
"bank_card": {
"number": "2200774546102058"
}
}
},
"participant_details": {
"recipient": {
"full_name": "Ivan Ivanovich Ivanov"
},
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"customer": {
"reference": "test"
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_12345",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.274416Z",
"updated_at": "2021-08-06T11:34:51.466550Z",
"payments": [{
"id": "po_25657",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545329Z",
"customer": {
"reference": "lucky"
},
"payment_method": {
"type": "card",
"card": {
"brand": "mir",
"last4": "2058"
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}],
"acquiring_payments": [{
"id": "pm_15174",
"status": "in_progress",
"created_at": "2021-08-06T11:34:51.545232Z",
"customer": {
"reference": "lucky"
},
"payment_details": {
"type": "internal_transfer",
"internal_transfer": {
"type": "transfer_from_bank_account",
"transfer_from_bank_account": {
"description": "test payout",
"card_mask": "400000******0002"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "RUB"
},
"metadata": {
"key": "value"
},
"participant_details": {
"sender": {
"full_name": "Ivan Ivanovich Ivanov"
},
"recipient": {
"full_name": "Ivan Ivanovich Ivanov",
"reference": "1234"
}
}
}]
}
}

session/start/payout/rko​

Начало выплаты на банковский счет​

Метод для начала выплаты на банковский счет, в том числе через СБП, в рамках уже созданной сессии. В запросе можно передать недостающие параметры или заменить уже переданные.

Адрес для отправки запроса​

/api/v1/session/start/payout/rko

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор платежной сессии
payment_method+objectПлатежные данные для зачисления средств
amount_details+objectСумма. Значение в минорных единицах валюты. Например, чтобы передать 100 рублей, укажите 10000
participant_details+objectИнформация об отправителе и получателе
metadata-*Любые дополнительные данные, которые необходимы вам для проведения операции. Банк 131 возвращает их в ответах и вебхуках
Пример запроса
curl -X POST \
https://demo.bank131.ru/api/v1/session/start/payout/rko \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_3230",
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810300000000006",
"full_name": "Вектор",
"inn": "1234567890",
"kpp": "165801002",
"description": "Перевод с расчетного счета на счет другого ЮЛ, открытого в Банке 131"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810900000000011"
}
}
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
session-objectПлатежная сессия
error-objectОшибка
Примеры ответов
{
"status": "ok",
"session": {
"id": "ps_3230",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"updated_at": "2025-05-27T02:03:00.000000Z",
"payments": [{
"id": "po_2025",
"status": "in_progress",
"created_at": "2025-05-27T02:03:00.000000Z",
"customer": {
"reference": "user123",
"contacts": [{
"email": "user@gmail.com"
}]
},
"payment_method": {
"type": "bank_account",
"bank_account": {
"system_type": "ru",
"ru": {
"bik": "049205131",
"account": "40702810300000000006",
"full_name": "Вектор",
"inn": "1234567890",
"kpp": "165801002",
"description": "Перевод с расчетного счета на счет другого ЮЛ, открытого в Банке 131"
}
}
},
"amount_details": {
"amount": 10000,
"currency": "rub"
},
"participant_details": {
"sender": {
"account": "40702810900000000011"
}
},
"metadata": "good"
}]
}
}

Прочее​

sberpay/push​

Проверка статуса оплаты​

Метод для запроса статуса оплаты через SberPay.

Адрес для отправки запроса​

/api/v1/sberpay/push

Параметры запроса​

НазваниеОбязательностьТипОписание
session_id+stringИдентификатор сессии
phone+stringНомер телефона для отправки push-уведомления или СМС
Пример запроса
curl -X GET \
https://demo.bank131.ru/api/v1/sberpay/push \
-H 'Content-Type: application/json' \
-H 'X-PARTNER-PROJECT: your_project_name' \
-H 'X-PARTNER-SIGN: signature' \
-d '{
"session_id": "ps_75459435",
"phone": "+79638594ххх"
}'

Параметры ответа​

НазваниеОбязательностьТипОписание
status+stringСтатус. Возможные значения: error, ok
error-objectОшибка
Примеры ответов
{
"status": "ok"
}