Пром GET https://baas.alfabank.ru/api/pp/v1/operations
Песочница GET https://sandbox.alfabank.ru/api/pp/v1/operations
Scope
operations-history
Описание
Возвращает историю всех совершённых операций по карте/счёту с указанием детальной информации по каждой из них, например: дата, сумма, направление движения денежных средств, статус операции.
Параметры запроса
application/json
Bearer {access_token}, полученный по Authorization Code Flow
Дата начала запроса истории операций (включительно) в формате yyyy-MM-dd
Дата окончания запроса истории операций (включительно) в формате yyyy-MM-dd
Массив номеров счетов для выборки истории операций
Массив идентификаторов пластиковых карт для выборки истории операций
Направление движения денежных средств. Принимает возможные значения: INCOME
- приход/пополнение; EXPENSE
- расход/списание
Параметр пагинации - Смещение от начала
Параметр пагинации - Запрашиваемое кол-во элементов на странице
curl -X GET https://baas.alfabank.ru/api/pp/v1/operations?dateFrom=2018-03-15&dateTo=2018-03-16&accounts=11112222333344445555&cards=1111222233334444&operationDirection=EXPENSE&offset=0&limit=100 \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'
Параметры ответа
{
"operations": [
{
"id": "1220117MOCOIBSR 04461",
"dateTime": "2022-01-17T14:47:49.65Z",
"title": "МТС 9166666666",
"amount": {
"value": 100,
"currency": "RUR",
"minorUnits": 100
},
"comment": "Перевод за услуги IPTV",
"mcc": "4899",
"category": {
"id": "00012",
"name": "Телефон, интернет, ТВ"
},
"direction": "EXPENSE",
"loyalty": {
"title": "Компенсация за плату услуг Альфа картой",
"percent": 10,
"amount": {
"value": 100,
"currency": "RUR",
"minorUnits": 100
}
},
"status": "SUCCESS",
"type": "A01",
"terminal": {
"number": "123456789",
"name": "МТС online",
"city": "Moscow",
"countryCode": "RU"
},
"sender": {
"name": "Сидоров Сидор Сидорович",
"accountNumber": "40817810810210032401",
"bankBik": "044525593",
"bankName": "Альфа Банк",
"phoneNumber": 79201112222,
"maskedCardNumber": "1111XXXXXXXX2222"
},
"recipient": {
"name": "МТС",
"bankBik": "044525500",
"bankName": "ООО МТС Банк",
"phoneNumber": 12223334455
},
"fee": 50,
"isAnotherClient": false,
"cashout": false
},
{
"id": "1220618MOCOIBSR 00789",
"dateTime": "2022-03-18T18:03:02.681Z",
"title": "123123",
"amount": {
"value": 100,
"currency": "RUR",
"minorUnits": 100
},
"direction": "EXPENSE",
"fee": 0,
"isAnotherClient": false,
"cashout": false,
"comment": null,
"mcc": null,
"category": {
"id": "00012",
"name": "Телефон, интернет, ТВ"
},
"loyalty": null,
"status": "SUCCESS",
"type": "A01",
"terminal": {
"number": "-1",
"name": null,
"city": null,
"countryCode": null
},
"sender": {
"name": null,
"accountNumber": "40817810310210282379",
"bankBik": null,
"bankName": null,
"phoneNumber": null,
"maskedCardNumber": null
},
"recipient": {
"name": "билайн",
"bankBik": null,
"bankName": null,
"phoneNumber": null
},
"reference": "CRD_1SUBUR"
}
]
}
Идентификатор операции
Дата и время операции
Заголовок операции
Значение
Код валюты
Минорные единицы
Направление движения денежных средств. Принимает возможные значения: INCOME
- приход/пополнение; EXPENSE
- расход/списание
Комиссия по операции
Признак того, что операция выполнена другим клиентом
Признак снятия наличности в банкомате
Комментарий к операции
MCC код операции
Идентификатор категории
Наименование категории
Заголовок бонусной программы / программы лояльности
Процент от суммы
Значение
Код валюты
Минорные единицы
Статус операции. Принимает возможные значения: null
- входящая операция или статус не определен; SUCCESS
- операция выполнена успешна; HOLD
- операция в обработке; FAILED
- операция не выполнена
Тип операции
Номер терминала точки продаж
Имя точки продаж
Город точки продаж (код)
Страна точки продаж (код)
Отправитель перевода
Номер счёта отправителя перевода / клиента
БИК банка отправителя
Название банка отправителя
Номер телефона отправителя
Номер карты (маскированный) отправителя
Получатель перевода
БИК банка получателя
Название банка получателя
Номер телефона получателя
Идентификатор операции из EQ
{
"operations": [
{
"id": "1220117MOCOIBSR 04461",
"dateTime": "2022-01-17T14:47:49.65Z",
"title": "МТС 9166666666",
"amount": {
"value": 100,
"currency": "RUR",
"minorUnits": 100
},
"comment": "Перевод за услуги IPTV",
"mcc": "4899",
"category": {
"id": "00012",
"name": "Телефон, интернет, ТВ"
},
"direction": "EXPENSE",
"loyalty": {
"title": "Компенсация за плату услуг Альфа картой",
"percent": 10,
"amount": {
"value": 100,
"currency": "RUR",
"minorUnits": 100
}
},
"status": "SUCCESS",
"type": "A01",
"terminal": {
"number": "123456789",
"name": "МТС online",
"city": "Moscow",
"countryCode": "RU"
},
"sender": {
"name": "Сидоров Сидор Сидорович",
"accountNumber": "40817810810210032401",
"bankBik": "044525593",
"bankName": "Альфа Банк",
"phoneNumber": 79201112222,
"maskedCardNumber": "1111XXXXXXXX2222"
},
"recipient": {
"name": "МТС",
"bankBik": "044525500",
"bankName": "ООО МТС Банк",
"phoneNumber": 12223334455
},
"fee": 50,
"isAnotherClient": false,
"cashout": false
},
{
"id": "1220618MOCOIBSR 00789",
"dateTime": "2022-03-18T18:03:02.681Z",
"title": "123123",
"amount": {
"value": 100,
"currency": "RUR",
"minorUnits": 100
},
"direction": "EXPENSE",
"fee": 0,
"isAnotherClient": false,
"cashout": false,
"comment": null,
"mcc": null,
"category": {
"id": "00012",
"name": "Телефон, интернет, ТВ"
},
"loyalty": null,
"status": "SUCCESS",
"type": "A01",
"terminal": {
"number": "-1",
"name": null,
"city": null,
"countryCode": null
},
"sender": {
"name": null,
"accountNumber": "40817810310210282379",
"bankBik": null,
"bankName": null,
"phoneNumber": null,
"maskedCardNumber": null
},
"recipient": {
"name": "билайн",
"bankBik": null,
"bankName": null,
"phoneNumber": null
},
"reference": "CRD_1SUBUR"
}
]
}
Код ошибки. Принимает возможные значения: invalid_request
- Неверные входные параметры запроса
Описание ошибки
{
"error": "invalid_request",
"error_description": "Authorization header is not present in request headers"
}
Код ошибки. Принимает возможные значения: invalid_token
- Предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
Описание ошибки
{
"error": "invalid_token",
"error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
}
Код ошибки. Принимает возможные значения: insufficient_scope
- у пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; access_denied
- доступ к счету запрещен
Описание ошибки
{
"error": "insufficient_scope",
"error_description": "The request requires higher privileges than provided by the access token"
}
Код ошибки. Принимает возможные значения: unknown_endpoint
- Эндпоинт не найден или неактивен
Описание ошибки
{
"error": "unknown_route",
"error_description": "Route is not found or not active"
}
Код ошибки. Принимает возможные значения: internal_error
- Внутренняя ошибка сервиса при выполнении обработки запроса
Описание ошибки
{
"error": "internal_error",
"error_description": "Internal server error"
}
Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.