Выписка по счету

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

Чтобы получить выписку, используйте метод report/account_statement.

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

Название	Обязательность	Тип	Описание
account_number	+	string	Номер счета (20 цифр), по которому нужна выписка
date_from	+	date	Дата начала выписки. Например: 2023-06-01
date_to	+	date	Дата окончания выписки — должна совпадать с date_from. Например: 2023-06-01

Пример запроса выписки по счету

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	Сумма операции в иностранной валюте. Если операция в рублях, параметр заполнять необязательно
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"
  }
}

Невалидный запрос по формату JSON

{
  "status": "error",
  "error": {
    "description": "Invalid request",
    "code": "invalid_request"
  }
}

Внутренняя ошибка

Данный ответ возвращается в следующих случаях:

• номер счета указан неверно;
• указанного счета не существует;
• счет не принадлежит клиенту.

{
  "status": "error",
  "error": {
    "description": "Internal error",
    "code": "internal_error"
  }
}