Smart Online Broker API

Smart Online Broker API 1.0.0

0
Голосов пока нет

Smart Online Broker API АО “Банк ЦентрКредит" предназначен для интеграции Партнеров с системами Банка, предоставляющие Клиенту возможность покупки Товаров, в том числе с использованием Кредита/Рассрочки с пред одобрением решения, полученного в Банке

expand_moreexpand_lessКонтактная информация
АО «Банк ЦентрКредит»
development
https://api-test.bcc.kz/bcc/production

Точка подключения для вызова сервисов в тестовой среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"

production
development
https://api.bcc.kz:10443/bcc/production

Альтернативная точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"

production
https://api.bcc.kz/bcc/production

Точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"

development
https://api-sandbox.bcc.kz/bcc/production

Точка подключения для вызова сервисов в песочнице. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"

Пути

/pre-approved

post /pre-approved
Smart online broker

PreApproved

Authorization
Authorization
(oauth2 application)

Токен аутентификации полученный при вызове сервиса авторизации

Token URL
https://api.bcc.kz/bcc/production/v2/oauth/token
Scopes
bcc.application.broker
shymbolat.aitbek@bcc.kz
body
Required in body
object

Тело запроса

RequestBody
Content-Type
Опционально в header
string
application/json
Accept
Опционально в header
string
application/json
200

PreApproved handler success

ResponseBody
400

PreApproved handler errors

httperror.Details
500

PreApproved handler errors

httperror.Details
Пример запроса
Пример ответа
POST https://api-test.bcc.kz/bcc/production/v1/broker/pre-approved
Попробуйте выполнить эту операцию
https://api-test.bcc.kz/bcc/production/v1/broker/pre-approved
content-type
accept

/merchant-post-link

post /merchant-post-link
Smart online broker

Merchant postLink

Authorization
Authorization
(oauth2 application)

Токен аутентификации полученный при вызове сервиса авторизации

Token URL
https://api.bcc.kz/bcc/production/v2/oauth/token
Scopes
bcc.application.broker
shymbolat.aitbek@bcc.kz
body
Required in body
object

Тело запроса

MerchantRequestBody
Content-Type
Опционально в header
string
application/json
Accept
Опционально в header
string
application/json
200

Merchant postLink handler success

MerchantResponseBody
400

Merchant postLink handler errors

httperror.Details
500

Merchant postLink handler errors

httperror.Details
Пример запроса
Пример ответа
POST https://api-test.bcc.kz/bcc/production/v1/broker/merchant-post-link
Попробуйте выполнить эту операцию
https://api-test.bcc.kz/bcc/production/v1/broker/merchant-post-link
content-type
accept

Определения 

{
    "type": "object",
    "properties": {
        "code": {
            "type": "integer",
            "description": "Код ответа"
        },
        "message": {
            "type": "string",
            "description": "Сообщение об ответе"
        },
        "status": {
            "type": "string",
            "description": "Статус ответа"
        }
    },
    "additionalProperties": false
}
              
{
    "type": "object",
    "properties": {
        "address": {
            "$ref": "#\/definitions\/Address"
        },
        "channel": {
            "type": "string",
            "example": "web"
        },
        "customer": {
            "$ref": "#\/definitions\/Customer"
        },
        "goods": {
            "type": "array",
            "items": {
                "$ref": "#\/definitions\/Good"
            }
        },
        "isDelivery": {
            "type": "boolean",
            "example": true
        },
        "loanLength": {
            "type": "string",
            "example": "12"
        },
        "orderState": {
            "type": "string",
            "example": "INIT"
        },
        "paymentMethod": {
            "type": "string",
            "example": "annuity"
        },
        "productType": {
            "type": "string",
            "example": "loan"
        },
        "redirectUrl": {
            "type": "string",
            "example": "https:\/\/example.kz\/webhook"
        },
        "referenceId": {
            "type": "string",
            "example": "BGR1231"
        },
        "salesPlace": {
            "type": "string",
            "example": "050000"
        },
        "totalCost": {
            "type": "string",
            "example": "50000"
        },
        "verificationSmsCode": {
            "type": "string",
            "example": "1243"
        },
        "verificationSmsDateTime": {
            "type": "string",
            "example": "06.10.2023 10:07:23"
        }
    },
    "required": [
        "address",
        "channel",
        "customer",
        "goods",
        "isDelivery",
        "loanLength",
        "orderState",
        "paymentMethod",
        "productType",
        "redirectUrl",
        "referenceId",
        "salesPlace",
        "totalCost",
        "verificationSmsCode",
        "verificationSmsDateTime"
    ]
}
              
{
    "type": "object",
    "properties": {
        "delivery": {
            "type": "string",
            "description": "Адрес доставки товара",
            "example": "Улица Розыбакиева, 388\/Б2"
        },
        "pickupPoint": {
            "type": "string",
            "description": "Адрес пункта самовывоза",
            "example": "Mega Center Alma-Ata, Улица Розыбакиева, 263"
        }
    },
    "required": [
        "delivery",
        "pickupPoint"
    ]
}
              
{
    "type": "object",
    "properties": {
        "contact": {
            "$ref": "#\/definitions\/Contact"
        },
        "firstName": {
            "type": "string",
            "example": "Аскар"
        },
        "lastName": {
            "type": "string",
            "example": "Аскаров"
        },
        "middleName": {
            "type": "string",
            "example": "Аскарович"
        },
        "state": {
            "type": "string",
            "example": "orange"
        },
        "taxCode": {
            "type": "string",
            "example": "960629450735"
        }
    },
    "required": [
        "contact",
        "lastName",
        "firstName",
        "middleName",
        "state",
        "taxCode"
    ]
}
              
{
    "type": "object",
    "properties": {
        "email": {
            "type": "string",
            "example": "askar.askarov@gmail.com"
        },
        "mobileNumber": {
            "type": "string",
            "example": "7475774285"
        }
    },
    "required": [
        "email",
        "mobileNumber"
    ]
}
              
{
    "type": "object",
    "properties": {
        "brand": {
            "type": "string",
            "example": "apple"
        },
        "category": {
            "type": "string",
            "example": "accessories"
        },
        "image": {
            "type": "string",
            "example": "https:\/\/example.kz\/goods\/images\/airpods_pro_2"
        },
        "model": {
            "type": "string",
            "example": "AirPods Pro 2"
        },
        "price": {
            "type": "string",
            "example": "169990"
        },
        "sku": {
            "type": "string",
            "example": "ACS1"
        }
    },
    "required": [
        "brand",
        "image",
        "category",
        "model",
        "price",
        "sku"
    ]
}

Создание заявки и отправка продуктов

{
    "properties": {
        "code": {
            "type": "string",
            "description": "Код ответа",
            "example": "200"
        },
        "message": {
            "type": "string",
            "description": "Сообщение об ответе",
            "example": "Заявка успешно создана"
        },
        "requestUuid": {
            "type": "string",
            "description": "Уникальный идентификатор запроса",
            "example": "c5171b44-0bd3-6a2f-21aa-60ee039ddff3"
        },
        "redirectLink": {
            "type": "string",
            "description": "Ссылка для перенаправления",
            "example": "https:\/\/oprb-dev.bcc.kz\/epos\/?preapp=03e60d13-bd8a-29c8-a03c-ca9d74c63b83&lang=kk&v=2"
        },
        "status": {
            "type": "string",
            "description": "Статус ответа",
            "example": "Success"
        }
    },
    "additionalProperties": false
}
              
{
    "properties": {
        "code": {
            "type": "string",
            "description": "Код ответа",
            "example": "200"
        },
        "message": {
            "type": "string",
            "description": "Сообщение об ответе",
            "example": "Статус заявки успешно обновлен"
        },
        "status": {
            "type": "string",
            "description": "Статус ответа",
            "example": "Success"
        }
    },
    "additionalProperties": false
}
              
{
    "properties": {
        "loanLength": {
            "type": "string",
            "description": "Срок кредита в месяцах",
            "example": "12"
        },
        "productCode": {
            "type": "string",
            "description": "Код продукта",
            "example": "INS12"
        },
        "referenceId": {
            "type": "string",
            "description": "Уникальный идентификатор заказа",
            "example": "BGR1231"
        },
        "state": {
            "type": "string",
            "description": "Состояние заявки",
            "example": "CUSTOMER_REJECTED"
        },
        "stateTitle": {
            "type": "string",
            "description": "Название состояния",
            "example": "Клиент отказался"
        }
    },
    "additionalProperties": false,
    "required": [
        "stateTitle",
        "state",
        "referenceId",
        "productCode",
        "loanLength"
    ]
}