B2B

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

Песочница
POST https://sandbox.alfabank.ru/api/smart-loans/jp/v1/loan-applications
Пром
POST https://baas.alfabank.ru/api/smart-loans/jp/v1/loan-applications
Scope

loan-applications

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

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

application/json

Content-Type
stringrequired

application/json

BODY
Атрибут
Описание
dealId
stringrequired

Идентификатор черновика заявки (UUID, 128-битный)

objectoptional

Информация о кредитовании. Передаётся только для кредитования без РКО

platformId
stringrequired

Параметр инициализации процесса. Передаётся B2B

objectrequired

Информация о заёмщике

objectoptional

Информация о заёмщике-ИП

objectoptional

Информация о заёмщике

inn
stringrequired

ИНН ИП. Использовать только 12 цифр

ogrn
stringrequired

ОГРН ИП. Использовать только 15 цифр

kpp
stringoptional

КПП ИП. Использовать только 9 цифр

contactPhone
stringrequired

Контактный номер телефона ИП

objectoptional

Информация о заёмщике-юридическом лице

objectoptional

Информация о заёмщике

inn
stringrequired

ИНН юридического лица. Использовать только 10 цифр

ogrn
stringrequired

ОГРН юридического лица. Использовать только 13 цифр

kpp
stringrequired

КПП юридического лица. Использовать только 9 цифр

contactPhone
stringrequired

Контактный номер телефон юридического лица

objectrequired

Информация о работе заёмщика с партнёром

objectoptional

Информация о заказе клиента у партнёра. Передаётся, если platformId равен B2B

productCode
stringoptional

Продукт Банка, который выбрал клиент

number
stringrequired

Номер договора партнёра с клиентом на осуществление заказа

date
string(date)required

Дата заключения договора между клиентом и партнёром на осуществление заказа

amount
string(BigDecimal)required

Сумма заказа в рублях

objectrequired

Информация о ссылках для редиректа пользователя после успешной или неуспешной операции

success
stringrequired

Ссылка редиректа при успешной операции

failure
stringrequired

Ссылка редиректа при неуспешной операции

objectoptional

Информация о реквизитах для проведения платежа партнёру

transferType
stringoptional

Направление перевода денежных средств. Возможные значения:

  • •
    skipTransfer - перевод на рассчётный счёт заёмщика;
  • •
    transferTo3rdParty - перевод 3-му лицу по реквизитам
vat
booleanrequired

Признак включённого/невключённого НДС

vatAmount
string(BigDecimal)optional

Сумма включённого НДС в рублях. Передаётся, если vat равен true

objectoptional

Банковские реквизиты получателя платежа. Передаётся, если реквизиты для оплаты ранее не были переданы в Банк или transferType равен transferTo3rdParty

bankName
stringrequired

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

bankBIC
stringrequired

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

bankCorrespondentAccount
stringrequired

Корсчёт Банка получателя

recipientINN
stringrequired

ИНН получателя. Иcпользовать 10 или 12 цифр

recipientKPP
stringoptional

КПП получателя. Использовать только 9 цифр

recipientAccount
stringrequired

Расчётный счёт получателя

recipientName
stringrequired

Наименование получателя платежа

Пример запроса
1curl -X POST https://baas.alfabank.ru/api/smart-loans/jp/v1/loan-applications \
2  -H 'Accept: application/json' \
3  -H 'Authorization: Bearer {access-token}'\
4  -H 'Content-Type: application/json'
5  -d '{
6  "dealId": "c5f72949-0e9a-41bf-a16d-a34b938f41ef",
7  "application": {
8    "platformId": "B2B"
9  },
10  "borrower": {
11    "individual": {
12      "legalInfo": {
13        "inn": 770778659011,
14        "ogrn": "102773964228147",
15        "kpp": 770201001,
16        "contactPhone": "+7(916)545-00-00"
17      }
18    },
19    "legal": {
20      "legalInfo": {
21        "inn": 770778659011,
22        "ogrn": "1027739642281",
23        "kpp": 770201001,
24        "contactPhone": "+7(916)545-00-00"
25      }
26    }
27  },
28  "partner": {
29    "orderInfo": {
30      "productCode": "Рассрочка для партнёра",
31      "number": "2023-123-234-3459 ОТ",
32      "date": "2023-10-25",
33      "amount": "3284.17",
34      "returnURL": {
35        "success": "https://partner.example.ru/success",
36        "failure": "https://partner.example.ru/failure"
37      }
38    },
39    "paymentDetails": {
40      "transferType": "transferTo3rdParty",
41      "vat": true,
42      "vatAmount": "400.18",
43      "bankDetails": {
44        "bankName": "АО «Альфа-Банк», г. Москва",
45        "bankBIС": "044525593",
46        "bankCorrespondentAccount": "30101810200000000000",
47        "recipientINN": "5504036333",
48        "recipientKPP": "783801001",
49        "recipientAccount": "30101810200000000000",
50        "recipientName": "АКЦИОНЕРНОЕ ОБЩЕСТВО \"АЛЬФА-БАНК\""
51      }
52    }
53  }
54}'

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

Пример ответа 200 (ОК)
1{
2  "dealId": "c5f72949-0e9a-41bf-a16d-a34b938f41ef"
3}
dealId
stringrequired

Идентификатор черновика заявки (UUID, 128-битный)

Пример ответа 200 (ОК)
1{
2  "dealId": "c5f72949-0e9a-41bf-a16d-a34b938f41ef"
3}
error
stringrequired

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

error_description
stringoptional

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

Пример ошибки 400 (Bad Request)
1{
2  "error": "invalid_request",
3  "error_descriptions": "Значение атрибута transactions.sumTransactionsMSB[5].sum отсутствует; Партнёру ХХХХХХ недоступно оформление онлайн-кредита"
4}
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}
error
stringrequired

Код ошибки. Принимает возможные значения: insufficient_scope - при запросе токена доступа не были переданы все необходимые scopes. Необходимо повторно отправить запрос на получение токена доступа с указанием всех доступных scopes; 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}
error
stringrequired

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

error_description
stringoptional

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

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

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