B2C

Получение детальной информации по операции

Песочница
GET https://sandbox.alfabank.ru/api/pp/v1/operations/{id}
Пром
GET https://baas.alfabank.ru/api/pp/v1/operations/{id}
Scope

operations-history

Описание

Возвращает детальную информацию по конкретной совершённой операции, например: дата, сумма, направление движения денежных средств, статус операции.

Параметры запроса
HEADERS
Атрибут
Описание
Authorization
stringrequired
Accept
stringrequired

application/json

PATH
Атрибут
Описание
id
stringrequired
Пример запроса
Язык
1curl --location --globoff 'https://baas.alfabank.ru/api/api/pp/v1/operations/{id}' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'
Параметры ответа
Пример ответа 200 (OK)
1{
2  "id": "1220117MOCOIBSR 04461",
3  "dateTime": "2022-01-17T14:47:49.65Z",
4  "title": "МТС 9166666666",
5  "amount": {
6    "value": 100,
7    "currency": "RUR",
8    "minorUnits": 100
9  },
10  "comment": "Перевод за услуги IPTV",
11  "mcc": "4899",
12  "category": {
13    "id": "00012",
14    "name": "Телефон, интернет, ТВ"
15  },
16  "direction": "EXPENSE",
17  "loyalty": {
18    "title": "Компенсация за оплату услуг Альфа картой",
19    "percent": 10,
20    "amount": {
21      "value": 100,
22      "currency": "RUR",
23      "minorUnits": 100
24    }
25  },
26  "status": "SUCCESS",
27  "type": "A01",
28  "terminal": {
29    "number": "123456789",
30    "name": "МТС online",
31    "city": "Moscow",
32    "countryCode": "RU"
33  },
34  "sender": {
35    "name": "Сидоров Сидор Сидорович",
36    "accountNumber": "40817810810210032401",
37    "bankBik": "044525593",
38    "bankName": "Альфа Банк",
39    "phoneNumber": 79201112222,
40    "maskedCardNumber": "1111XXXXXXXX2222"
41  },
42  "recipient": {
43    "name": "МТС",
44    "bankBik": "044525500",
45    "bankName": "ООО МТС Банк",
46    "phoneNumber": 12223334455
47  },
48  "fee": 50,
49  "reference": "B011003220000249",
50  "isAnotherClient": false,
51  "cashout": false
52}
BODY
атрибут
описание
id
stringrequired

Идентификатор операции

dateTime
stringrequired

Дата и время операции

title
stringrequired

Заголовок операции

objectrequired

Сумма операции

value
integerrequired

Значение

currency
stringrequired

Код валюты

minorUnits
integerrequired

Минорные единицы

comment
stringoptional

Комментарий к операции

mcc
stringoptional

MCC-код операции

objectoptional

Категория программы лояльности

id
stringrequired

Идентификатор категории

name
stringrequired

Наименование категории

direction
stringrequired

Направление движения денежных средств:

  • INCOME - приход/пополнение
  • EXPENSE - расход/списание
objectoptional

Программа лояльности

title
stringoptional

Заголовок бонусной программы / программы лояльности

percent
numberoptional

Процент от суммы

objectoptional

Сумма операции

value
integerrequired

Значение

currency
stringrequired

Код валюты

minorUnits
integerrequired

Минорные единицы

status
stringoptional

Статус операции. Принимает возможные значения:

  • null - входящая операция или статус не определён;
  • SUCCESS - операция выполнена успешно;
  • HOLD - операция в обработке;
  • FAILED - операция не выполнена
type
stringoptional

Тип операции

objectoptional

Терминал точки продаж

number
stringoptional

Номер терминала точки продаж

name
stringoptional

Имя точки продаж

city
stringoptional

Город точки продаж (код)

countryCode
stringoptional

Страна точки продаж (код)

objectoptional

Отправитель перевода

name
stringoptional

Отправитель перевода

accountNumber
stringoptional

Номер счёта отправителя перевода / клиента

bankBik
stringoptional

БИК банка отправителя

bankName
stringoptional

Название банка отправителя

phoneNumber
stringoptional

Номер телефона отправителя

maskedCardNumber
stringoptional

Номер карты (маскированный) отправителя

objectoptional

Получатель перевода

name
stringoptional

Получатель перевода

bankBik
stringoptional

БИК банка получателя

bankName
stringoptional

Название банка получателя

phoneNumber
stringoptional

Номер телефона получателя

fee
numberrequired

Комиссия по операции

reference
stringoptional

Идентификатор операции из EQ

isAnotherClient
booleanrequired

Признак того, что операция выполнена другим клиентом

cashout
booleanrequired

Признак снятия наличности в банкомате

Пример ответа 200 (OK)
1{
2  "id": "1220117MOCOIBSR 04461",
3  "dateTime": "2022-01-17T14:47:49.65Z",
4  "title": "МТС 9166666666",
5  "amount": {
6    "value": 100,
7    "currency": "RUR",
8    "minorUnits": 100
9  },
10  "comment": "Перевод за услуги IPTV",
11  "mcc": "4899",
12  "category": {
13    "id": "00012",
14    "name": "Телефон, интернет, ТВ"
15  },
16  "direction": "EXPENSE",
17  "loyalty": {
18    "title": "Компенсация за оплату услуг Альфа картой",
19    "percent": 10,
20    "amount": {
21      "value": 100,
22      "currency": "RUR",
23      "minorUnits": 100
24    }
25  },
26  "status": "SUCCESS",
27  "type": "A01",
28  "terminal": {
29    "number": "123456789",
30    "name": "МТС online",
31    "city": "Moscow",
32    "countryCode": "RU"
33  },
34  "sender": {
35    "name": "Сидоров Сидор Сидорович",
36    "accountNumber": "40817810810210032401",
37    "bankBik": "044525593",
38    "bankName": "Альфа Банк",
39    "phoneNumber": 79201112222,
40    "maskedCardNumber": "1111XXXXXXXX2222"
41  },
42  "recipient": {
43    "name": "МТС",
44    "bankBik": "044525500",
45    "bankName": "ООО МТС Банк",
46    "phoneNumber": 12223334455
47  },
48  "fee": 50,
49  "reference": "B011003220000249",
50  "isAnotherClient": false,
51  "cashout": false
52}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_request - неверные входные параметры запроса
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 400 (Bad Request)
1{
2  "error": "invalid_request",
3  "error_description": "Authorization header is not present in request headers"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • invalid_token - предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 401 (Unauthorized)
1{
2  "error": "invalid_token",
3  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • insufficient_scope - у пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope;
  • access_denied - доступ к счёту запрещён
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 403 (Forbidden)
1{
2  "error": "insufficient_scope",
3  "error_description": "The request requires higher privileges than provided by the access token"
4}
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • unknown_endpoint - эндпоинт не найден или неактивен
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 404 (Not Found)
1{
2  "error": "unknown_endpoint",
3  "error_description": "Endpoint is not found or not active"
4}
Нет тела ответа
BODY
атрибут
описание
error
stringrequired

Код ошибки. Принимает возможные значения:

  • internal_error - внутренняя ошибка сервиса при выполнении обработки запроса
error_description
stringoptional

Сообщение об ошибке

Пример ошибки 500 (Internal Server Error)
1{
2  "error": "internal_error",
3  "error_description": "Internal server error"
4}
Нет тела ответа