Scope
operations-history
Описание
Возвращает историю всех совершённых операций по карте/счёту с указанием детальной информации по каждой из них, например: дата, сумма, направление движения денежных средств, статус операции.
Параметры запроса
Bearer {access_token}, полученный по Authorization Code Flow
application/json
Дата начала запроса истории операций (включительно) в формате YYYY-MM-DD
Дата окончания запроса истории операций (включительно) в формате YYYY-MM-DD
Массив номеров счетов для выборки истории операций
Массив идентификаторов пластиковых карт для выборки истории операций
Направление движения денежных средств. Возможные значения:
- •
INCOME- приход/пополнение; - •
EXPENSE- расход/списание
Количество объектов в списке, которые необходимо пропустить
Количество объектов на странице
1curl --location --globoff 'https://baas.alfabank.ru/api/pp/v1/operations?dateFrom={dateFrom}&dateTo={dateTo}&accounts={accounts}&cards={cards}&operationDirection={operationDirection}&offset={offset}&limit={limit}' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'Параметры ответа
1{
2 "operations": [
3 {
4 "id": "1220117MOCOIBSR 04461",
5 "dateTime": "2022-01-17T14:47:49.65Z",
6 "title": "МТС 9166666666",
7 "amount": {
8 "value": 100,
9 "currency": "RUR",
10 "minorUnits": 100
11 },
12 "comment": "Перевод за услуги IPTV",
13 "mcc": "4899",
14 "category": {
15 "id": "00012",
16 "name": "Телефон, интернет, ТВ"
17 },
18 "direction": "EXPENSE",
19 "loyalty": {
20 "title": "Компенсация за плату услуг Альфа картой",
21 "percent": 10,
22 "amount": {
23 "value": 100,
24 "currency": "RUR",
25 "minorUnits": 100
26 }
27 },
28 "status": "SUCCESS",
29 "type": "A01",
30 "terminal": {
31 "number": "123456789",
32 "name": "МТС online",
33 "city": "Moscow",
34 "countryCode": "RU"
35 },
36 "sender": {
37 "name": "Сидоров Сидор Сидорович",
38 "accountNumber": "40817810810210032401",
39 "bankBik": "044525593",
40 "bankName": "Альфа Банк",
41 "phoneNumber": 79201112222,
42 "maskedCardNumber": "1111XXXXXXXX2222"
43 },
44 "recipient": {
45 "name": "МТС",
46 "bankBik": "044525500",
47 "bankName": "ООО МТС Банк",
48 "phoneNumber": 12223334455
49 },
50 "fee": 50,
51 "isAnotherClient": false,
52 "cashout": false
53 }
54 ]
55}Список операций
Идентификатор операции
Дата и время операции
Заголовок операции
Сумма операции
Значение
Код валюты
Минорные единицы
Комментарий к операции
MCC-код операции
Категория программы лояльности
Идентификатор категории
Наименование категории
Направление движения денежных средств. Возможные значения:
- •
INCOME- приход/пополнение; - •
EXPENSE- расход/списание
Программа лояльности
Заголовок бонусной программы или программы лояльности
Процент от суммы
Сумма по программе
Значение
Код валюты
Минорные единицы
Статус операции. Принимает возможные значения:
- •
null- входящая операция или статус не определён; - •
SUCCESS- операция выполнена успешно; - •
HOLD- операция в обработке; - •
FAILED- операция не выполнена
Тип операции
Терминал точки продаж
Номер терминала точки продаж
Имя точки продаж
Город точки продаж (код)
Страна точки продаж (код)
Отправитель перевода
Отправитель перевода
Номер счёта отправителя перевода / клиента
БИК банка отправителя
Название банка отправителя
Номер телефона отправителя
Номер карты (маскированный) отправителя
Получатель перевода
Получатель перевода
БИК банка получателя
Название банка получателя
Номер телефона получателя
Комиссия по операции
Идентификатор операции из EQ
Признак того, что операция выполнена другим клиентом
Признак снятия наличности в банкомате
1{
2 "operations": [
3 {
4 "id": "1220117MOCOIBSR 04461",
5 "dateTime": "2022-01-17T14:47:49.65Z",
6 "title": "МТС 9166666666",
7 "amount": {
8 "value": 100,
9 "currency": "RUR",
10 "minorUnits": 100
11 },
12 "comment": "Перевод за услуги IPTV",
13 "mcc": "4899",
14 "category": {
15 "id": "00012",
16 "name": "Телефон, интернет, ТВ"
17 },
18 "direction": "EXPENSE",
19 "loyalty": {
20 "title": "Компенсация за плату услуг Альфа картой",
21 "percent": 10,
22 "amount": {
23 "value": 100,
24 "currency": "RUR",
25 "minorUnits": 100
26 }
27 },
28 "status": "SUCCESS",
29 "type": "A01",
30 "terminal": {
31 "number": "123456789",
32 "name": "МТС online",
33 "city": "Moscow",
34 "countryCode": "RU"
35 },
36 "sender": {
37 "name": "Сидоров Сидор Сидорович",
38 "accountNumber": "40817810810210032401",
39 "bankBik": "044525593",
40 "bankName": "Альфа Банк",
41 "phoneNumber": 79201112222,
42 "maskedCardNumber": "1111XXXXXXXX2222"
43 },
44 "recipient": {
45 "name": "МТС",
46 "bankBik": "044525500",
47 "bankName": "ООО МТС Банк",
48 "phoneNumber": 12223334455
49 },
50 "fee": 50,
51 "isAnotherClient": false,
52 "cashout": false
53 }
54 ]
55}Код ошибки. Принимает возможные значения:
- •
invalid_request- неверные входные параметры запроса
Сообщение об ошибке
1{
2 "error": "invalid_request",
3 "error_description": "Authorization header is not present in request headers"
4}Код ошибки. Принимает возможные значения:
- •
invalid_token- предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
Сообщение об ошибке
1{
2 "error": "invalid_token",
3 "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}Код ошибки. Принимает возможные значения:
- •
insufficient_scope- при запросе кода авторизации не были переданы все необходимые scopes. Необходимо переподписать договор согласия, повторно отправив запрос на получение кода авторизации с указанием всех доступных scopes и параметраprompt=consent; - •
access_denied- доступ к счёту запрещён
Сообщение об ошибке
1{
2 "error": "insufficient_scope",
3 "error_description": "The request requires higher privileges than provided by the access token"
4}Код ошибки. Принимает возможные значения:
- •
unknown_endpoint- эндпоинт не найден или неактивен
Сообщение об ошибке
1{
2 "error": "unknown_endpoint",
3 "error_description": "Endpoint is not found or not active"
4}Код ошибки. Принимает возможные значения:
- •
internal_error- внутренняя ошибка сервиса при выполнении обработки запроса
Сообщение об ошибке
1{
2 "error": "internal_error",
3 "error_description": "Internal server error"
4}