СКОРО В РЕЛИЗЕB2B

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

Песочница
GET https://sandbox.alfabank.ru/api/loans/jp/v1/applications/{applicationId}/decision
Пром
GET https://baas.alfabank.ru/api/loans/jp/v1/applications/{applicationId}/decision
Scope

loan-applications

Описание

Метод позволяет получить результаты скоринга по идентификатору кредитной заявки.

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

application/json

PATH
Атрибут
Описание
applicationId
stringrequired
Пример запроса
Язык 
1curl --location --globoff 'https://baas.alfabank.ru/api/loans/jp/v1/applications/{applicationId}/decision' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Accept: application/json'
Параметры ответа
Пример ответа 200 (OK) 
1{
2  "applicationId": "3780558a-7360-4dd2-b4c8-738227d9c236",
3  "status": "ACCEPT",
4  "customTermsAvailable": true,
5  "loanProduct": "LT01",
6  "offers": [
7    {
8      "id": "5",
9      "specialOfferTitle": "string",
10      "productInfoOverrides": [
11        {
12          "name": "term",
13          "value": "До 120 месяцев"
14        }
15      ],
16      "additionalDescription": [
17        {
18          "text": "Условия лучше с залогом"
19        }
20      ],
21      "loanProduct": "Залоговый Лайт",
22      "productCode": "UL01",
23      "availableActions": [
24        "nextStage"
25      ],
26      "rate": "19",
27      "interestRates": [
28        {
29          "type": "DAILY",
30          "isActive": true,
31          "rate": "0.3"
32        }
33      ],
34      "scheduleType": "ANNUITY",
35      "minimumAmount": "500000",
36      "maximumAmount": "2500000",
37      "maxSumWithOptions": "2439024",
38      "selectedAmountByClient": null,
39      "canChangeAmount": false,
40      "term": "12",
41      "monthlyPaymentAmount": 225056,
42      "productDescription": "Кредит на развитие бизнеса с залогом. Зачислим на ваш расчётный счёт.",
43      "linkToProduct": "https://link.alfabank.ru/showcase/landing-modal/cc75343b-ab11-4688-b266-4dcaf77365a2",
44      "isProlongationAvailable": true,
45      "smeLendingConditions": {
46        "conditionsGovernmentSupport": "clientHasExcisableOKVEDWithAmountLimit",
47        "loanAmountWithoutOKVEDRemove": "9999999",
48        "loanAmountWithoutOKVEDRemoveWithOption": "9756097",
49        "specifyConditionsMessage": "Имеются ОКВЭД, которые могут не попадать под условия кредита с господдержкой. Сообщите клиенту",
50        "infoMessage": "Уточните у клиента, есть ли у него действующие кредиты с поручительством КМСП. Если есть, не подключайте господдержку. Иначе ставка по новому кредиту может быть увеличена в одностороннем порядке после заключения сделки"
51      },
52      "monetaryTurnover": {
53        "amount": "500000",
54        "description": "Рассчитывается как 20% от суммы кредита. Выбирая этот продукт, вам будет нужно обеспечить ежемесячное поступление денег на расчётный счёт. Не учитываются перечисления между своими счетами и другие внесения, которые не являются выручкой от продаж товаров, работ или услуг.",
55        "rate": null
56      },
57      "blocker": {
58        "description": "Для оформления этого продукта придется закрыть один из действующих кредитных продуктов",
59        "type": "Product compatibility conflict"
60      },
61      "warningMessages": [
62        "Для оформления этого продукта, в сделке должен быть как минимум один поручитель"
63      ],
64      "isOnlineSigningAvailable": true,
65      "highLoanRate": 0,
66      "nonRevolvingTrancheDueDate": "2026-05-28",
67      "gracePeriod": 0,
68      "variants": [
69        {
70          "id": "1_VMS2FEE1",
71          "term": "18",
72          "subType": "annual",
73          "limitType": "SUBLM",
74          "loanProduct": "Подписка 1%",
75          "isSelected": false,
76          "fee": 1,
77          "cost": 12345,
78          "rateDiscount": 3,
79          "trancheTerm": 365,
80          "interestRate": "1"
81        }
82      ],
83      "compatibility": [
84        {
85          "productCode": "UL03",
86          "productName": "Залоговый Лайт с СУФЭА",
87          "productAccount": "40702810000000000733",
88          "compatibilityCode": "1",
89          "compatibilityDescription": "Рекомендуется открыть новый счет"
90        }
91      ]
92    }
93  ],
94  "declineReasons": [
95    {
96      "code": "OR218",
97      "text": "Техническая ошибка ПО Hunter. Направьте заявку на скоринг повторно. Если ошибка повторится отправьте скрин и номер заявки с вопросом на HELPDESK/alfa-bank"
98    }
99  ]
100}
BODY
атрибут
описание
applicationId
stringoptional

Идентификатор кредитной заявки

status
stringoptional

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

  • •
    ACCEPT - заявка одобрена;
  • •
    DECLINE - отказ по заявке
customTermsAvailable
booleanoptional

Признак доступности индивидуального рассмотрения

loanProduct
stringoptional

Тип продукта

array of objectsoptional

Список предложений (решений)

id
stringrequired

Идентификатор предложения

specialOfferTitle
stringoptional

Описание специального предложения для продукта

array of objectsoptional

Переопределённые параметры продукта

name
stringoptional

Наименование параметра

value
stringoptional

Значение параметра

array of objectsoptional

Дополнительное описание

text
stringoptional

Текст дополнительного описания

loanProduct
stringoptional

Наименование продукта

productCode
stringoptional

Код продукта

availableActions
array of stringsoptional

Доступные действия по заявке на данном этапе. Принимает возможные значения:

  • •
    sendToManager - отправка заявки на клиентского менеджера;
  • •
    previousStage - возврат заявки на предыдущий этап;
  • •
    nextStage - отправка заявки на следующий этап;
  • •
    toFullForm - отправка заявки на заполнение полных анкетных данных;
  • •
    showReworkHistory - отображение истории возвратов заявки на доработку
rate
stringoptional

Ставка по кредиту, %

array of objectsoptional

Варианты ставок по кредиту

type
stringoptional

Периодичность процентной ставки. Возможные значения:

  • •
    ANNUAL - годовая;
  • •
    MONTHLY - месячная;
  • •
    DAILY - дневная
isActive
booleanoptional

Признак активности данного типа ставки

rate
stringoptional

Значение ставки

scheduleType
stringoptional

Тип графика погашения. Возможные значения:

  • •
    ANNUITY - аннуитетные платежи;
  • •
    DIFFERENTIATED - дифференцированные платежи;
  • •
    BULLET - буллитный график погашения (шаровые платежи)
minimumAmount
stringoptional

Минимально возможная сумма кредита, руб.

maximumAmount
stringoptional

Максимально возможная сумма кредита, руб.

maxSumWithOptions
stringoptional

Предельная сумма клиентской части кредита при подключении платных опций, стоимость которых включается в тело кредита, руб.

selectedAmountByClient
numberoptional

Сумма кредита, выбранная клиентом, руб.

canChangeAmount
booleanoptional

Признак возможности скорректировать сумму кредита

term
stringoptional

Срок действия договора в месяцах

monthlyPaymentAmount
numberoptional

Сумма ежемесячного платежа (для аннуитетного графика погашения), руб.

productDescription
stringoptional

Описание продукта

linkToProduct
stringoptional

Ссылка на продукт

isProlongationAvailable
booleanoptional

Признак бессрочности продукта (автоматической пролонгации)

objectoptional

Условия кредитования малого и среднего предпринимательства (МСП)

conditionsGovernmentSupport
stringoptional

Условие подключения льготного кредитования. Принимает возможные значения:

  • •
    governmentSupportAvailable - господдержка применима, ограничений нет;
  • •
    removalProhibitedOKVEDRequired - требуется согласие клиента на удаление запрещённого ОКВЭД из выписки ЕГРЮЛ/ЕГРИП;
  • •
    clientHasExcisableOKVED - клиент имеет подакцизные ОКВЭД;
  • •
    clientHasExcisableOKVEDWithAmountLimit - клиент имеет подакцизные ОКВЭД и основной ОКВЭД, не равный 55/56, поэтому в случае подключения страховки за счёт кредитных средств сумма будет уменьшена до значения, указанного в loanAmountWithoutOKVEDRemoveWithOption;
  • •
    removalExcisableOKVEDRequired - клиент имеет подакцизные ОКВЭД, в случае отказа от удаления которых сумма кредита будет уменьшена до значения, указанного в loanAmountWithoutOKVEDRemove;
  • •
    removalProhibitedOKVEDRequiredAndHasExcisableOKVED - клиент имеет подакцизные и запрещённые ОКВЭД;
  • •
    removalProhibitedOKVEDRequiredAndHasExcisableOKVEDWithAmountLimit - клиент имеет подакцизные и запрещенные ОКВЭД. Получение поддержки возможно при удалении из выписки ЕГРЮЛ/ЕГРИП запрещённых ОКВЭД и при условии, что основной ОКВЭД не равен 55/56. В случае подключения страховки за счёт кредитных средств сумма будет уменьшена до значения, указанного в loanAmountWithoutOKVEDRemoveWithOption
loanAmountWithoutOKVEDRemove
stringoptional

Сумма кредита без удаления ОКВЭД, руб.

loanAmountWithoutOKVEDRemoveWithOption
stringoptional

Сумма кредита без удаления ОКВЭД с учетом подключенной страховки, руб.

specifyConditionsMessage
stringoptional

Информационное сообщение об условиях подключения КМСП

infoMessage
stringoptional

Информационное сообщение, описывающее условие получения господдержки

objectoptional

Поддержание денежного оборота

amount
stringoptional

Сумма, руб.

description
stringoptional

Описание

rate
numberoptional

Процентная ставка

objectoptional

Ограничения по продукту

description
stringoptional

Описание ограничения

type
stringoptional

Ограничение, выявленное в результате проверки совместимости продуктов и наличия доступных счетов

warningMessages
array of stringsoptional

Список причин, блокирующих оформление продукта

isOnlineSigningAvailable
booleanoptional

Признак доступности онлайн-подписания договора

highLoanRate
numberoptional

Повышенная ставка при просрочке

nonRevolvingTrancheDueDate
stringoptional

Дата погашения транша по невозобновляемой кредитной линии (НКЛ) в формате YYYY-MM-DD

gracePeriod
integeroptional

Льготный (грейс) период

array of objectsoptional

Варианты решений

id
stringoptional

Идентификатор варианта решения

term
stringoptional

Срок действия договора в месяцах

subType
stringoptional

Подтип варианта решения

limitType
stringoptional

Тип решения. Принимает возможные значения:

  • •
    SUBLM - с подпиской;
  • •
    STND - без подписки
loanProduct
stringoptional

Описание варианта решения

isSelected
booleanoptional

Признак выбранного клиентом варианта

fee
numberoptional

Комиссия за подключение подписки в процентах

cost
numberoptional

Стоимость подписки

rateDiscount
numberoptional

Процент, на который снижается ставка при подключении подписки

trancheTerm
integeroptional

Срок транша в днях

interestRate
stringoptional

Конечная ставка по кредиту с учетом дисконта

array of objectsoptional

Совместимые продукты

productCode
stringoptional

Код продукта

productName
stringoptional

Наименование продукта

productAccount
stringoptional

Номер счёта, на который открыт продукт

compatibilityCode
stringoptional

Тип ограничения по кредитованию. Принимает возможные значения:

  • •
    0 - недоступно;
  • •
    1 - доступно, есть рекомендации;
  • •
    2 - есть особенности погашения
compatibilityDescription
stringoptional

Описание ограничения

array of objectsoptional

Список причин отказа

code
stringoptional

Код причины отказа

text
stringoptional

Текст причины отказа

Пример ответа 200 (OK) 
1{
2  "applicationId": "3780558a-7360-4dd2-b4c8-738227d9c236",
3  "status": "ACCEPT",
4  "customTermsAvailable": true,
5  "loanProduct": "LT01",
6  "offers": [
7    {
8      "id": "5",
9      "specialOfferTitle": "string",
10      "productInfoOverrides": [
11        {
12          "name": "term",
13          "value": "До 120 месяцев"
14        }
15      ],
16      "additionalDescription": [
17        {
18          "text": "Условия лучше с залогом"
19        }
20      ],
21      "loanProduct": "Залоговый Лайт",
22      "productCode": "UL01",
23      "availableActions": [
24        "nextStage"
25      ],
26      "rate": "19",
27      "interestRates": [
28        {
29          "type": "DAILY",
30          "isActive": true,
31          "rate": "0.3"
32        }
33      ],
34      "scheduleType": "ANNUITY",
35      "minimumAmount": "500000",
36      "maximumAmount": "2500000",
37      "maxSumWithOptions": "2439024",
38      "selectedAmountByClient": null,
39      "canChangeAmount": false,
40      "term": "12",
41      "monthlyPaymentAmount": 225056,
42      "productDescription": "Кредит на развитие бизнеса с залогом. Зачислим на ваш расчётный счёт.",
43      "linkToProduct": "https://link.alfabank.ru/showcase/landing-modal/cc75343b-ab11-4688-b266-4dcaf77365a2",
44      "isProlongationAvailable": true,
45      "smeLendingConditions": {
46        "conditionsGovernmentSupport": "clientHasExcisableOKVEDWithAmountLimit",
47        "loanAmountWithoutOKVEDRemove": "9999999",
48        "loanAmountWithoutOKVEDRemoveWithOption": "9756097",
49        "specifyConditionsMessage": "Имеются ОКВЭД, которые могут не попадать под условия кредита с господдержкой. Сообщите клиенту",
50        "infoMessage": "Уточните у клиента, есть ли у него действующие кредиты с поручительством КМСП. Если есть, не подключайте господдержку. Иначе ставка по новому кредиту может быть увеличена в одностороннем порядке после заключения сделки"
51      },
52      "monetaryTurnover": {
53        "amount": "500000",
54        "description": "Рассчитывается как 20% от суммы кредита. Выбирая этот продукт, вам будет нужно обеспечить ежемесячное поступление денег на расчётный счёт. Не учитываются перечисления между своими счетами и другие внесения, которые не являются выручкой от продаж товаров, работ или услуг.",
55        "rate": null
56      },
57      "blocker": {
58        "description": "Для оформления этого продукта придется закрыть один из действующих кредитных продуктов",
59        "type": "Product compatibility conflict"
60      },
61      "warningMessages": [
62        "Для оформления этого продукта, в сделке должен быть как минимум один поручитель"
63      ],
64      "isOnlineSigningAvailable": true,
65      "highLoanRate": 0,
66      "nonRevolvingTrancheDueDate": "2026-05-28",
67      "gracePeriod": 0,
68      "variants": [
69        {
70          "id": "1_VMS2FEE1",
71          "term": "18",
72          "subType": "annual",
73          "limitType": "SUBLM",
74          "loanProduct": "Подписка 1%",
75          "isSelected": false,
76          "fee": 1,
77          "cost": 12345,
78          "rateDiscount": 3,
79          "trancheTerm": 365,
80          "interestRate": "1"
81        }
82      ],
83      "compatibility": [
84        {
85          "productCode": "UL03",
86          "productName": "Залоговый Лайт с СУФЭА",
87          "productAccount": "40702810000000000733",
88          "compatibilityCode": "1",
89          "compatibilityDescription": "Рекомендуется открыть новый счет"
90        }
91      ]
92    }
93  ],
94  "declineReasons": [
95    {
96      "code": "OR218",
97      "text": "Техническая ошибка ПО Hunter. Направьте заявку на скоринг повторно. Если ошибка повторится отправьте скрин и номер заявки с вопросом на HELPDESK/alfa-bank"
98    }
99  ]
100}
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 - при запросе токена доступа не были переданы все необходимые scopes. Необходимо повторно отправить запрос на получение токена доступа с указанием всех доступных scopes
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}
Нет тела ответа

Отправьте письмо на alfa_api@alfabank.ru, указав следующие данные:

  1. 1.
    client_id.
  2. 2.
    Дата и время запроса с указанием часового пояса.
  3. 3.
    Метод и URI запроса.
  4. 4.
    Заголовки и тело запроса.
  5. 5.
    Полученная ошибка и заголовки ответа, включая X-TraceId.
  6. 6.
    IP-адрес, с которого был отправлен запрос.
Изменение статуса кредитной заявкиОтправка решения клиента по кредиту