На стороне партнёра должен быть реализован метод POST с URL, на который будет отправляться сообщение о статусе кредитной заявки.
Авторизация
Реализованный метод должен быть закрыт авторизацией, поэтому необходимо отправить письмо на почту alfa_api@alfabank.ru с данными, как авторизоваться в методе, в теме письма нужно указать "Авторизация для получения статусов по кредитной заявке". Для авторизации запросов может использоваться Client Credentials Flow (RFC 6749) или Basic Authentication (RFC 7617).
Кредитные заявки
В запросе метода «Отправка данных для скоринга и создания черновика заявки» партнёр передаёт уникальный идентификатор черновика заявки ( dealId ). По данному идентификатору однозначно можно определить, по какой заявке был отправлен статус.
Параметры запроса
Идентификатор черновика заявки (UUID, 128-битный)
Дата и время отправки статуса партнёру
Признак, что заявка была направлена в Банк, ушла из онлайн процесса и работа с заявкой ведётся на стороне менеджера
Признак определяет возможность получения документов от партнёра и загрузку этих документов в заявку
Признак будет отправлен в случае получения критичного отказа при проверке. Необходимо скрыть баннер Альфа-Банка от клиента, чтобы он не смог повторно завести заявку до времени dateOfReapplication
Дата, в которую можно повторно отобразить баннер клиенту, чтобы он мог повторно отправить заявку
Информация о заёмщике
ИНН заёмщика, передаваемый в черновик кредитной заявки
Информация по статусу кредитной заявки
Статус заявки
Расшифровка статуса
Информация по результатам скоринга
Решение, которое было получено в ходе полной проверки компании по ИНН
Предложения, которыми может воспользоваться клиент
Идентификатор предложения
Признак того, что клиент выбрал определённый лимит
Код продукта в банке
Наименование продукта
Процентная ставка, одобренная клиенту
Минимальная сумма, которую банк одобрил клиенту
Максимальная сумма, которую банк одобрил клиенту
Сумма, которую выбрал клиент
Срок одобренного кредита
Информация об авторизации сделки в банке
Дата, в которую клиенту были перечислены денежные средства на его расчётный счёт
Причина, по которой кредитная заявка была закрыта
Код причины
Текст причины
1curl -X POST https://status.partner.ru/api/v1/statuses \
2{
3 "dealId":"f19ba9b9-8e3d-4397-96c8-8ba1840e1fc9",
4 "createDate":"2023-01-01T00:00:00.000Z",
5 "isSentToManager":false,
6 "isPossibleForUploadingDocs":true,
7 "isPossibleReapplication":true,
8 "dateOfReapplication":null,
9 "borrower":{
10 "inn":"7728168971",
11 },
12 "statusInfo":{
13 "status":"Scoring L Result",
14 "statusExplanation":"Получено предварительное решение по кредиту"
15 },
16 "scoringInfo":{
17 "decision":"ACCEPT",
18 "offers":[
19 {
20 "id":1,
21 "isSelected":false,
22 "productCode":"BP11",
23 "loanProduct":"Бизнес-кредит OW",
24 "interestRate":11.5,
25 "minimumAmount":500000,
26 "maximumAmount":3000000,
27 "term":36
28 },
29 {
30 "id":2,
31 "isSelected":false,
32 "productCode":"UP03",
33 "loanProduct":"Овердрафт OW",
34 "interestRate":12.5,
35 "minimumAmount":500000,
36 "maximumAmount":5000000,
37 "term":18
38 },
39 {
40 "id":3,
41 "isSelected":false,
42 "productCode":"VMS2",
43 "loanProduct":"Возобновляемая кредитная линия OW",
44 "interestRate":14.5,
45 "minimumAmount":100000,
46 "maximumAmount":7000000,
47 "term":18
48 }
49 ]
50 },
51 "authorizationInfo":{
52 "authorizationDate":null
53 },
54 "closeReason":{
55 "reasonCode":null,
56 "reasonText":null
57 }
58}Параметры ответа
В случае успешной обработки ответа на стороне партнёра необходимо вернуть код успешной обработки (200).
Допустимые статусы по кредитной заявке
| Статус | Расшифровка статуса | Описание |
|---|---|---|
| Scoring F Result | Пройдена предварительная проверка компании по ИНН | Клиент заполнил короткую анкету на кредит и получил предварительное решение по итогу проверки компании по ИНН |
| Scoring L Result | Получено предварительное решение по кредиту | Клиент заполнил полную анкету на кредит, загрузил сканы паспортов, подписал согласие на поход банка в БКИ и по итогу полной проверки получил предварительное решение |
| Full Form | Рассмотрение в банке, проводится дополнительный анализ | Заявка клиента находится на полном рассмотрении в банке, проводится дополнительный финансовый анализ для принятия финального решения |
| Agreement With Client | Согласование финального решения с клиентом | Согласование финального решения с клиентом |
| Awaiting Authorization Availability | Ожидание авторизации | Документы подписаны, заявка ожидает открытия банковского дня для завершения операций |
| Accept | Кредит выдан | Кредит выдан |
| Decline | Отказ банка/клиента по заявке | Отказ банка/клиента по заявке |
| Closed | Отказ по техническим причинам | Заявка закрыта по техническим причинам |
Допустимые статусы по скорингу
| Статус | Описание |
|---|---|
| ACCEPT | Заявка одобрена |
| DECLINE | Отказ по заявке |
Допустимые причины закрытия заявки
| Причина | Текст | Описание |
|---|---|---|
| BANK | Отказ Банка | По итогам проверок клиент получил отказ в кредитовании |
| CLIENT | Отказ Клиента | Клиент отказался от предложенных продуктов банка |
| SYSTEM | Техническая ошибка | Возникла критичная техническая ошибка, дальнейшая работа с заявкой невозможна |