B2C

Получение реквизитов счета

Пром GET https://baas.alfabank.ru/api/pp/v1/accounts/{accountNumber}/requisites

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

Scope

accounts

Описание

С помощью данного метода, пользователь может получить реквизиты конкретного счёта, которые могут использоваться для приёма платежей или выставления счетов.

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

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

application/json

Authorization
stringrequired

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

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

Номер счета. Для того, чтобы получить accountNumber используйте метод Получение списка счетов клиента

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

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

Пример ответа 200 (ОК)
{
  "clientInfo": {
    "firstName": "Владимир",
    "lastName": "Медведев",
    "patronymicName": "Александрович",
    "translitFirstName": null,
    "translitLastName": null,
    "translitPatronymicName": null
  },
  "accountNumber": "40817810704980004078",
  "bankName": "АО «Альфа-Банк», г. Москва",
  "bic": "044525593",
  "inn": "7728168971",
  "kpp": "770801001",
  "swift": null,
  "correspondentAccountNumber": "30101810200000000593",
  "correspondentBanks": [
    {
      "correspondentBankAccountNumber": "36310481",
      "correspondentSwift": "CITIUS33",
      "correspondentBankName": "CITIBANK NA, 399 Park Avenue, New York, NY 10043, USA"
    }
  ]
}
objectrequired

Информация по клиенту

firstName
stringrequired

Имя

lastName
stringrequired

Фамилия

patronymicName
stringoptional

Отчество

translitFirstName
stringoptional

Транслитерация имени (для валютных счетов)

translitLastName
stringoptional

Транслитерация фамилии (для валютных счетов)

translitPatronymicName
stringoptional

Транслитерация отчества (для валютных счетов)

accountNumber
stringrequired

Номер счета клиента

bankName
stringrequired

Полное наименование Банка

bic
stringoptional

БИК Банка

inn
stringoptional

ИНН Банка

kpp
stringoptional

КПП Банка

swift
stringoptional

SWIFT код Банка

correspondentAccountNumber
stringoptional

Корреспондентский счет

array of objectoptional

Массив банков-корреспондентов (для SWIFT переводов)

correspondentBankAccountNumber
stringrequired

Номер счета в Банке-корреспонденте

correspondentBankName
stringoptional

Полное наименование Банка-корреспондента

correspondentSwift
stringrequired

SWIFT-код Банка-корреспондента

Пример ответа 200 (ОК)
{
  "clientInfo": {
    "firstName": "Владимир",
    "lastName": "Медведев",
    "patronymicName": "Александрович",
    "translitFirstName": null,
    "translitLastName": null,
    "translitPatronymicName": null
  },
  "accountNumber": "40817810704980004078",
  "bankName": "АО «Альфа-Банк», г. Москва",
  "bic": "044525593",
  "inn": "7728168971",
  "kpp": "770801001",
  "swift": null,
  "correspondentAccountNumber": "30101810200000000593",
  "correspondentBanks": [
    {
      "correspondentBankAccountNumber": "36310481",
      "correspondentSwift": "CITIUS33",
      "correspondentBankName": "CITIBANK NA, 399 Park Avenue, New York, NY 10043, USA"
    }
  ]
}
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_endpoint",
  "error_description": "Endpoint 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"
}
Нет тела ответа

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