Scope
escrow
Описание
Метод позволяет создать заявку на резервирование счёта эскроу с расширенными входными параметрами. Метод стоит использовать, если Вы обладаете расширенными данными депонента, для того, чтобы не отправлять дополнительно сканы документов.
Параметры запроса
Bearer {access_token}, полученный по Authorization Code Flow / Authorization Code Flow H2H
application/json
application/json
Счёт эскроу
Депонируемая сумма
Валюта. Возможные значения:
- •
RUR- рублёвая валюта
Объект строительства
Типы объектов недвижимости. Принимает возможные значения:
- •
FLAT- квартира; - •
PARKING- машиноместо; - •
PANTRY- кладовая; - •
NON_RESIDENTIAL_PREMISES- нежилое помещение; - •
GARAGE- гараж; - •
COMMERCIAL_PREMISES- коммерческое помещение; - •
APARTMENTS- апартаменты; - •
ROOM- комната; - •
RESIDENTIAL-PREMISES- жилой дом
Номер квартиры объекта строительства
Информация об объекте строительства
Номер РНС (разрешение на строительство)
Этап строительства. Можно указать только один этап
Порядковый номер этапа строительства в пределах проекта
Данные депонента
Фамилия депонента
Имя депонента
Отчество депонента
Дата рождения депонента
Тип ДУЛа. Возможные значения:
- •
001- паспорт гражданина РФ; - •
002- загранпаспорт гражданина РФ
Серия ДУЛ депонента
Номер ДУЛ депонента
Дата выдачи ДУЛ депонента
Место рождения
Адрес регистрации
Контактный номер телефона менеджера клиента
Контактный адрес электронной почты менеджера клиента для уточнения данных о депоненте
Мобильный телефон депонента
ДДУ
Номер ДДУ
Дата подписания ДДУ
1curl --location 'https://baas.alfabank.ru/api/jp/v1/escrow-orders-full' \
2--header 'Authorization: Bearer {access-token}' \
3--header 'Content-Type: application/json' \
4--header 'Accept: application/json' \
5--data-raw '{
6 "escrowAccount": {
7 "amount": 112500,
8 "currency": "RUR"
9 },
10 "estateObject": {
11 "type": "APARTMENTS",
12 "flat": 1,
13 "buildProject": {
14 "buildingPermitNumber": "61-310-998601-2022",
15 "phases": {
16 "index": 1
17 }
18 }
19 },
20 "depositor": {
21 "lastName": "Федькин",
22 "firstName": "Ратибор",
23 "middleName": "Васильевич",
24 "birthdate": "1990-08-30",
25 "identityDocumentType": "001",
26 "identityDocumentSeries": "1234",
27 "identityDocumentNumber": "123456",
28 "dateIssuedId": "2020-02-10",
29 "birthPlace": "г. Москва",
30 "regAddress": "Ул. Соцветий, д12, кв. 1",
31 "managerContactPhoneNumber": "75453333435",
32 "managerContactEmail": "manager@gmail.com",
33 "phoneNumber": "75453333435"
34 },
35 "equalityAgreement": {
36 "number": "5555",
37 "date": "2020-01-01"
38 }
39}'Параметры ответа
1{
2 "referenceID": "EA10509220000013",
3 "status": "VERIFICATION"
4}Номер заявки на резервирование счёта эскроу
Статус заявки. Принимает возможные значения:
- •
VERIFICATION- пользователь внёс все данные по заявке и нажал 'Отправить заявку'; - •
CLIENT_CANCELLED- депонент изменил решение по открытию счёта эскроу; - •
VERIFICATION_ERROR- депонент не прошёл проверку (Отклонена банком); - •
SIGNING- все проверки пройдены, эскроу-счёт зарезервирован. Ожидается подписание заявления депонента в офисе Банка; - •
WAITING_DDU- депонент подписал заявление в офисе Банка, счёт эскроу переведён в бух. режим, ожидается регистрация ДДУ застройщиком; - •
EXECUTED- заявление депонента подписано, получена отметка от застройщика о факте регистрации ДДУ; - •
DRAFT- пользователь сохранил черновик заявки
1{
2 "referenceID": "EA10509220000013",
3 "status": "VERIFICATION"
4}Код ошибки. Принимает возможные значения:
- •
invalid_request- неверные входные параметры запроса
Описание ошибки
1{
2 "error": "invalid_request",
3 "error_description": "Authorization header is not present in request headers"
4}Код ошибки. Принимает возможные значения:
- •
invalid_token- предоставленный токен просрочен, отозван, имеет неправильный формат или недействителен по другим причинам
Описание ошибки
1{
2 "error": "invalid_token",
3 "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
4}Код ошибки. Принимает возможные значения:
- •
insufficient_scope- у пользователя нет прав на использование запрашиваемого сервиса, доступ к которому не предусмотрен настройками scope; - •
access_denied- доступ к счёту запрещён
Описание ошибки
1{
2 "error": "insufficient_scope",
3 "error_description": "The request requires higher privileges than provided by the access token"
4}Код ошибки. Принимает возможные значения:
- •
unknown_endpoint- эндпоинт не найден или неактивен
Описание ошибки
1{
2 "error": "unknown_endpoint",
3 "error_description": "Endpoint is not found or not active"
4}Код ошибки. Принимает возможные значения:
- •
internal_error- внутренняя ошибка сервиса при выполнении обработки запроса
Описание ошибки
1{
2 "error": "internal_error",
3 "error_description": "Internal server error"
4}Значения параметров ошибок могут изменяться. Рекомендуем предусмотреть стандартную обработку ошибок, не описанных в текущей версии документации.