Сервис по работе со счетами эскроу
Альтернативная точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
Точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
Точка подключения для вызова сервисов в тестовой среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"
Пути
/ext/deals
Создать
Создает запись о сделке и отправляет Push покупателю
Токен аутентификации полученный при вызове сервиса авторизации
Create request
Токен клиента
Bad Request
/ext/deals/{id}
Получить по ID
Возвращает информацию по сделке
Токен аутентификации полученный при вызове сервиса авторизации
ID сделки
Токен клиента
Bad Request
Обновить статус сделки
Запускает процесс по проверке регистрации сделки
Токен аутентификации полученный при вызове сервиса авторизации
ID сделки
Токен клиента
Bad Request
/buyer/accept/{id}
Accept Escrow application
Подтвердить заявление на открытие Escrow счета
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
{
"schema": {
"type": "string"
}
}
Bad Request
/buyer/code/iin/{iin}
Получить SMS code для выгрузки документа из ГДБФЛ
Получить SMS code по ИИН для выгрузки документа из ГДБФЛ
Токен аутентификации полученный при вызове сервиса авторизации
ИИН
Токен клиента
200 OK
Bad Request
/buyer/list
Получить список заявление Escrow
Получить список заявление Escrow
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/buyer/{bin}/id/{id}
Просмотр заявление Escrow
Просмотр заявление Escrow
Токен аутентификации полученный при вызове сервиса авторизации
БИН
Идентификатор
Токен клиента
200 OK
Bad Request
/buyer/cancel/{id}
Подтвердить отмену заявление на открытие Escrow счета
Подтвердить отмену заявление на открытие Escrow счета
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
Идентификатор
200 OK
{
"schema": {
"type": "string"
}
}
Bad Request
/save
Создать заявление для выпуска Escrow
Создать заявление для выпуска Escrow юр. лиц
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
The input CreateEscrowApplicationRequest struct
200 OK
Bad Request
/approve/{id}
Одобрить заявку для выпуска Escrow
Одобрить заявку для выпуска Escrow юр. лиц
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
ID заявки
The input EscrowApplication struct
200 OK
Bad Request
/sent/{id}
Отправить заявку для выпуска Escrow
Отправить заявку для выпуска Escrow
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
ID заявки
The input EscrowSign struct
200 OK
Bad Request
/list
Получить список заявление Escrow
Получить список заявление Escrow
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/{id}
Получить заявление Escrow по id
Получить заявление Escrow по id
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
ID заявки
200 OK
Bad Request
/{escrow_id}/trustee-persons
Список доверенных лиц
Получить список доверенных лиц Escrow заявки
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
ID заявки
200 OK
{
"schema": {
"type": "integer"
}
}
Bad Request
/update/{id}
Обновить заявление
Обновить заявление
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
ID заявки
200 OK
Bad Request
/agree/unlock/buyer/cancel
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/agree/unlock/buyer/list
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/agree/unlock/buyer/accept
Список заявлений для снятие средств
Список заявлений для снятие средств
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/agree/unlock/save
Создает заявку на снятие блокировки суммы для Эскроу счета
Создает заявку на снятие блокировки суммы для Эскроу счета
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/agree/unlock/approve
Метод позволяет одобрить заявку
Метод позволяет одобрить заявку
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/agree/unlock/{bin}/{id}
Просмотр заявки по BIN и AgreeID
Просмотр заявки по BIN и AgreeID
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
БИН
ID заявки
200 OK
Bad Request
/agree/unlock/update/{id}
Обновление заявки
Обновление заявки
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
ID заявки
200 OK
Bad Request
/agree/unlock/remove/{id}
Создает заявку на снятие блокировки суммы для Эскроу счета
Создает заявку на снятие блокировки суммы для Эскроу счета
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
ID заявки
200 OK
Bad Request
/agree/unlock/list
Возвращает список заявок на снятие
Возвращает список заявок на снятие
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
200 OK
Bad Request
/report/close/view/{id}
Предварительный просмотр заявление закрытия эскроу счета
Предварительный просмотр заявление закрытия эскроу счета
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
id
200 OK
Bad Request
/report/unlock/view/{id}
Предварительный просмотр заявление разблокировки суммы
Предварительный просмотр заявление разблокировки суммы
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
id
200 OK
Bad Request
/report/{id}
Получить файл
Получить файл из ЦЭА или minio
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
id
200 OK
Bad Request
/report/list/{id}
Получить список файлов
Получить список файлов из ЦЭА или minio
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
id
200 OK
Bad Request
/report/consent/view/{id}
Предварительный просмотр согласие на сбор данных
Предварительный просмотр согласие на сбор данных
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
id
200 OK
Bad Request
/close/approve/{id}
Одобрить заявку для закрытия Escrow юр. лиц
Одобрить заявку для закрытия Escrow
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
id
The input EscrowSign struct
200 OK
Bad Request
/close/{id}
Закрытие Escrow application
Закрытие Escrow application
Токен аутентификации полученный при вызове сервиса авторизации
Токен клиента
id
200 OK
{
"schema": {
"type": "string"
}
}
Bad Request
Определения
{
"type": "object",
"properties": {
"result": {
"type": "string",
"description": "Результат операции",
"example": "success - успешный"
},
"resultMessage": {
"type": "string",
"description": "Текстовое сообщение"
},
"resultObject": {
"$ref": "#\/definitions\/CreateResponse",
"description": "Дополнительные данные"
}
}
}
{
"type": "object",
"properties": {
"address": {
"$ref": "#\/definitions\/Address",
"description": "Адрес"
},
"amount": {
"type": "number",
"description": "Сумма сделки"
},
"buyer": {
"$ref": "#\/definitions\/Participant",
"description": "Покупатель"
},
"cadastralNumber": {
"type": "string",
"description": "Кадастровый номер недвижимости"
},
"city": {
"type": "string",
"description": "Город обслуживания"
},
"dueDate": {
"type": "string",
"description": "Срок выполнения сделки"
},
"externalId": {
"type": "string",
"description": "Номер заявки"
},
"seller": {
"$ref": "#\/definitions\/Participant",
"description": "Продавец"
}
},
"required": [
"address",
"amount",
"buyer",
"cadastralNumber",
"city",
"dueDate",
"seller",
"externalId"
]
}
{
"type": "object",
"properties": {
"dealId": {
"type": "string",
"example": "fed3352a-13f8-4c72-802e-ecb69c317be3",
"description": "Уникальный идентификатор сделки"
}
}
}
{
"type": "object",
"properties": {
"result": {
"type": "string",
"description": "Результат операции",
"example": "success - успешный"
},
"resultMessage": {
"type": "string",
"description": "Текстовое сообщение"
},
"resultObject": {
"$ref": "#\/definitions\/ActualDeal",
"description": "Дополнительные данные"
}
}
}
{
"type": "object",
"properties": {
"buildingNumber": {
"type": "string",
"description": "Номер дома"
},
"district": {
"type": "string",
"description": "Район"
},
"flatNumber": {
"type": "string",
"description": "Номер квартиры"
},
"region": {
"type": "string",
"description": "Регион"
},
"street": {
"type": "string",
"description": "Улица"
},
"town": {
"type": "string",
"description": "Город"
},
"fullAddress": {
"type": "string",
"description": "Полный адрес"
}
},
"required": [
"buildingNumber",
"district",
"region",
"street",
"town"
]
}
{
"type": "object",
"properties": {
"accountNumber": {
"type": "string"
},
"fullName": {
"type": "string",
"description": "ФИО продавца\/покупателя"
},
"iin": {
"type": "string",
"description": "ИИН продавца\/покупателя"
},
"phoneNumber": {
"type": "string",
"description": "Номер телефона"
},
"signDate": {
"type": "string",
"description": "Дата подписания"
}
},
"required": [
"iin",
"fullName",
"phoneNumber"
]
}
{
"type": "object",
"properties": {
"accountNumber": {
"type": "string",
"description": ""
},
"accountStatus": {
"type": "string",
"description": "Статус счета (смотри Список статусов)"
},
"address": {
"$ref": "#\/definitions\/Address",
"description": "Адрес"
},
"amount": {
"type": "number",
"description": "Сумма сделки"
},
"buyer": {
"$ref": "#\/definitions\/Participant",
"description": "Информация о покупателе"
},
"cadastralNumber": {
"type": "string",
"description": "Кадастровый номер недвижимости"
},
"city": {
"type": "string",
"description": "Город обслуживания"
},
"contractStatus": {
"type": "string",
"description": "Статус договора"
},
"dueDate": {
"type": "string",
"description": "Срок выполнения сделки"
},
"externalId": {
"type": "string",
"description": "Номер заявки"
},
"id": {
"type": "string",
"example": "fed3352a-13f8-4c72-802e-ecb69c317be3",
"description": "Уникальный идентификатор сделки"
},
"openedAt": {
"type": "string",
"description": "Дата открытия эскроу счета"
},
"seller": {
"$ref": "#\/definitions\/Participant",
"description": "Информация о продавце"
}
}
}
{
"properties": {
"data": {
"type": "string"
},
"sucess": {
"type": "boolean"
}
},
"additionalProperties": false
}
{
"properties": {
"bin": {
"type": "string"
},
"id": {
"type": "integer"
},
"iin": {
"type": "string"
},
"sign_request": {
"type": "string"
}
},
"additionalProperties": false
}
{
"type": "object",
"properties": {
"auth_key": {
"$ref": "#\/definitions\/AuthKey"
},
"contract_date": {
"type": "string"
},
"contract_expired": {
"type": "string"
},
"documents_file_base64": {
"type": "string"
},
"escrow": {
"$ref": "#\/definitions\/EscrowApplication"
},
"persons": {
"type": "array",
"items": {
"$ref": "#\/definitions\/TrusteePerson"
}
},
"user_info": {
"$ref": "#\/definitions\/UserClaim"
}
}
}
{
"type": "object",
"properties": {
"Channel": {
"type": "string"
},
"username": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"approve_bank": {
"type": "integer"
},
"approve_bank_message": {
"type": "string"
},
"buyer_address": {
"type": "string"
},
"buyer_bik": {
"type": "string"
},
"buyer_bin": {
"type": "string"
},
"buyer_doc_id_begdate": {
"type": "string"
},
"buyer_doc_id_num": {
"type": "string"
},
"buyer_first_name": {
"type": "string"
},
"buyer_iban": {
"type": "string"
},
"buyer_iin": {
"type": "string"
},
"buyer_kbe": {
"type": "string"
},
"buyer_last_name": {
"type": "string"
},
"buyer_long_name": {
"type": "string"
},
"buyer_mail": {
"type": "string"
},
"buyer_middle_name": {
"type": "string"
},
"buyer_phone": {
"type": "string"
},
"cli_bin": {
"type": "string"
},
"cli_code": {
"type": "string"
},
"cli_first_name": {
"type": "string"
},
"cli_iban": {
"type": "string"
},
"cli_iin": {
"type": "string"
},
"cli_kbe": {
"type": "string"
},
"cli_last_name": {
"type": "string"
},
"cli_long_name": {
"type": "string"
},
"cli_phone": {
"type": "string"
},
"cli_type": {
"type": "integer"
},
"contract_amount": {
"type": "number"
},
"contract_date": {
"type": "string"
},
"contract_expired": {
"type": "string"
},
"contract_num": {
"type": "string"
},
"contract_target": {
"type": "string"
},
"contract_val": {
"type": "string"
},
"count_code": {
"type": "integer"
},
"created_at": {
"type": "string"
},
"dep_code": {
"type": "string"
},
"doc_num": {
"type": "string"
},
"escrow_iban": {
"type": "string"
},
"escrow_tranche": {
"type": "boolean"
},
"expired_at": {
"type": "string"
},
"id": {
"type": "integer"
},
"reason": {
"type": "string"
},
"signature_a": {
"type": "string"
},
"signature_a_id": {
"type": "integer"
},
"signature_b": {
"type": "string"
},
"signature_b_id": {
"type": "integer"
},
"status": {
"type": "string"
},
"updated_at": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"created_at": {
"type": "string"
},
"email": {
"type": "string"
},
"escrow_id": {
"type": "integer"
},
"expired_date": {
"type": "string"
},
"first_name": {
"type": "string"
},
"id": {
"type": "integer"
},
"iin": {
"type": "string"
},
"is_main": {
"type": "boolean"
},
"last_name": {
"type": "string"
},
"middle_name": {
"type": "string"
},
"num_doc": {
"type": "string"
},
"phone": {
"type": "string"
},
"sign_date_create_app": {
"type": "string"
},
"start_date": {
"type": "string"
},
"updated_at": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"firstname": {
"type": "string"
},
"firstsignature": {
"type": "boolean"
},
"id": {
"type": "integer"
},
"iin": {
"type": "string"
},
"lastname": {
"type": "string"
},
"middlename": {
"type": "string"
},
"organization": {
"type": "object",
"properties": {
"approvalType": {
"type": "string"
},
"cliCode": {
"type": "string"
},
"clientType": {
"type": "string"
},
"customerId": {
"type": "integer"
},
"customerName": {
"type": "string"
},
"idn": {
"type": "string"
}
}
},
"secondsignature": {
"type": "boolean"
},
"username": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"cli_login": {
"type": "string"
},
"created_at": {
"type": "string"
},
"escrow_id": {
"type": "integer"
},
"id": {
"type": "integer"
},
"idn": {
"type": "string"
},
"sign_request": {
"type": "string"
},
"status": {
"type": "string"
},
"updated_at": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"amount": {
"type": "number"
},
"message": {
"type": "string"
},
"status": {
"type": "string"
},
"unlockId": {
"type": "integer"
},
"сounterparty": {
"$ref": "#\/definitions\/CounterpartyPayment"
}
}
}
{
"type": "object",
"properties": {
"counterparty": {
"$ref": "#\/definitions\/CounterpartyPayment"
},
"isCounterparty": {
"type": "boolean"
},
"unlock": {
"$ref": "#\/definitions\/DBUnlockAgree"
}
}
}
{
"type": "object",
"properties": {
"amount": {
"type": "number"
},
"bic": {
"type": "string"
},
"created_at": {
"type": "string"
},
"description": {
"type": "string"
},
"iban": {
"type": "string"
},
"id": {
"type": "integer"
},
"idn": {
"type": "string"
},
"knp": {
"type": "string"
},
"knp_name": {
"type": "string"
},
"longname": {
"type": "string"
},
"nds": {
"type": "boolean"
},
"unlock_id": {
"type": "integer"
}
}
}
{
"type": "object",
"properties": {
"amount": {
"type": "number"
},
"counterparty_pay": {
"type": "boolean"
},
"created_dt": {
"type": "string"
},
"error_message": {
"type": "string"
},
"escrowId": {
"type": "integer"
},
"id": {
"type": "integer"
},
"reason": {
"type": "string"
},
"status": {
"type": "string"
},
"updated_dt": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"base64": {
"type": "string"
},
"entity_id": {
"type": "integer"
}
}
}
{
"type": "object",
"properties": {
"cea_file_id": {
"type": "integer"
},
"created_at": {
"type": "string"
},
"document_type": {
"description": "STATEMENT, CONTRACT и т.д",
"type": "string"
},
"entity_id": {
"description": "id записи escrow или unlock и т.д",
"type": "integer"
},
"entity_type": {
"description": "тип сущности ESCROW_APPLICATION, UNLOCK_AGREES и т.д",
"type": "string"
},
"err_message": {
"type": "string"
},
"file_name": {
"type": "string"
},
"iban": {
"type": "string"
},
"id": {
"type": "integer"
},
"status": {
"type": "string"
},
"updated_at": {
"type": "string"
}
}
}