B2C

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

Пром GET https://baas.alfabank.ru/api/pp/v1/operations/{id}

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

Scope

operations-history

Описание

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

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

HEADERS
Атрибут
Описание
Accept
stringrequired

application/json

Authorization
stringrequired

Bearer {access_token}, полученный по Authorization Code Flow

PATH
Атрибут
Описание
id
stringrequired

Идентификатор операции. Для получения id используйте метод Получение истории операций

Пример запроса
curl -X GET https://baas.alfabank.ru/api/pp/v1/operations/1220310MOCOIBSR%2006141 \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer {access-token}'

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

Пример ответа 200 (ОК)
{
  "id": "1220310MOCOIBSR 06141",
  "dateTime": "2022-03-10T13:30:58.393Z",
  "title": "Между своими счетами",
  "amount": {
    "value": 111100,
    "currency": "RUR",
    "minorUnits": 100
  },
  "direction": "EXPENSE",
  "fee": 0,
  "isAnotherClient": false,
  "cashout": false,
  "comment": null,
  "mcc": null,
  "category": {
    "id": "00025",
    "name": "Прочие расходы"
  },
  "loyalty": {
    "title": "Операция 1",
    "percent": 10,
    "amount": {
      "value": 500,
      "currency": "RUB",
      "minorUnits": 100
    }
  },
  "status": "SUCCESS",
  "type": "B01",
  "terminal": {
    "number": "-1",
    "name": null,
    "city": null,
    "countryCode": null
  },
  "sender": {
    "name": "Иванов Иван Иванович",
    "accountNumber": "40817810010210282378",
    "bankBik": "044525593",
    "bankName": "АО \"АЛЬФА-БАНК\"",
    "phoneNumber": null,
    "maskedCardNumber": null
  },
  "recipient": {
    "name": "МТС",
    "bankBik": "044525593",
    "bankName": "ООО МТС Банк",
    "phoneNumber": null
  },
  "reference": "B011003220000249"
}
id
stringrequired

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

dateTime
stringrequired

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

title
stringrequired

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

Objectrequired

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

value
integerrequired

Значение

currency
stringrequired

Код валюты

minorUnits
integerrequired

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

direction
stringrequired

Направление движения денежных средств. Принимает возможные значения: INCOME - приход/пополнение; EXPENSE - расход/списание

fee
numberrequired

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

isAnotherClient
booleanrequired

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

cashout
booleanrequired

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

comment
stringoptional

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

mcc
stringoptional

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

Objectoptional

Объект программы лояльности

id
stringrequired

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

name
stringrequired

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

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

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

reference
stringoptional

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

Пример ответа 200 (ОК)
{
  "id": "1220310MOCOIBSR 06141",
  "dateTime": "2022-03-10T13:30:58.393Z",
  "title": "Между своими счетами",
  "amount": {
    "value": 111100,
    "currency": "RUR",
    "minorUnits": 100
  },
  "direction": "EXPENSE",
  "fee": 0,
  "isAnotherClient": false,
  "cashout": false,
  "comment": null,
  "mcc": null,
  "category": {
    "id": "00025",
    "name": "Прочие расходы"
  },
  "loyalty": {
    "title": "Операция 1",
    "percent": 10,
    "amount": {
      "value": 500,
      "currency": "RUB",
      "minorUnits": 100
    }
  },
  "status": "SUCCESS",
  "type": "B01",
  "terminal": {
    "number": "-1",
    "name": null,
    "city": null,
    "countryCode": null
  },
  "sender": {
    "name": "Иванов Иван Иванович",
    "accountNumber": "40817810010210282378",
    "bankBik": "044525593",
    "bankName": "АО \"АЛЬФА-БАНК\"",
    "phoneNumber": null,
    "maskedCardNumber": null
  },
  "recipient": {
    "name": "МТС",
    "bankBik": "044525593",
    "bankName": "ООО МТС Банк",
    "phoneNumber": null
  },
  "reference": "B011003220000249"
}
error
stringrequired

Код ошибки. Принимает возможные значения: invalid_request - Неверные входные параметры запроса

error_description
stringoptional

Описание ошибки

Пример ошибки 400 (Bad Request)
{
  "error": "invalid_request",
  "error_description": "Authorization header is not present in request headers"
}
error
stringrequired

Код ошибки. Принимает возможные значения: invalid_token - Предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам

error_description
stringoptional

Описание ошибки

Пример ошибки 401 (Unauthorized)
{
  "error": "invalid_token",
  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
}
error
stringrequired

Код ошибки. Принимает возможные значения: insufficient_scope - у пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; access_denied - доступ к счету запрещен

error_description
stringoptional

Описание ошибки

Пример ошибки 403 (Forbidden)
{
  "error": "insufficient_scope",
  "error_description": "The request requires higher privileges than provided by the access token"
}
error
stringrequired

Код ошибки. Принимает возможные значения: unknown_endpoint - Эндпоинт не найден или неактивен

error_description
stringoptional

Описание ошибки

Пример ошибки 404 (Not Found)
{
  "error": "unknown_route",
  "error_description": "Route is not found or not active"
}
Нет тела ответа
error
stringrequired

Код ошибки. Принимает возможные значения: internal_error - Внутренняя ошибка сервиса при выполнении обработки запроса

error_description
stringoptional

Описание ошибки

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

Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.