Альтернативная точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
Точка подключения для вызова сервиса в продуктивной среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "PRODUCTION"
Точка подключения для вызова сервисов в тестовой среде. Зарегистрированное на портале developer.bcc.kz приложение должно быть в режиме "DEVELOPMENT"
Пути
/accounts
Получение списка счетов
Токен аутентификации, полученный при вызове сервиса авторизации
Токен клиента
/accounts/{iban}/statement
Выписка по счету
Токен аутентификации, полученный при вызове сервиса авторизации
Токен клиента
Номер 20 разрядного счета по которому требуется получение информации
{
"pattern": "^KZ[A-Z0-9]{18}$"
}
Дата начала периода (YYYY-MM-DD)
Дата окончания периода (YYYY-MM-DD)
Валюта выписки
200 OK
BadRequest
Unauthorized
Forbidden
Internal Server Error
/transfers/xml
Получение данные перевода в xml
Токен аутентификации, полученный при вызове сервиса авторизации
Токен клиента
Идентификатор транзакции
200 OK
{
"schema": {
"type": "string",
"example": " \n \n KCJBKZKX<\/bank_id_db>\n KZ948502203106201650<\/account_db>\n KZ24070105KSN0000000<\/rnn_db>\n 061140003010<\/idn_db>\n 15<\/kod>\n KKMFKZ2A<\/bank_id_cr>\n KZ24070105KSN0000000<\/account_cr>\n null<\/rnn_cr>\n 940740000624<\/idn_cr>\n 23-03-2023<\/valuedate>\n 23-03-2023<\/date_doc>\n 19<\/ndoc>\n 19<\/kbe>\n 913<\/knp>\n 123456<\/taxcode>\n 123<\/amount>\n 664794<\/id>\n <\/root>"
}
}
/transfers
Список переводов
Токен аутентификации, полученный при вызове сервиса авторизации
Токен клиента
Дата начала периода "dd-MM-yyyy"
Дата окончания периода "dd-MM-yyyy"
Номер 20 разрядного счета по которому требуется получение информации
Номер страницы (по умолчанию 0)
Количество элементов на странице (по умолчанию 10)
Создание перевода
Токен аутентификации, полученный при вызове сервиса авторизации
Токен клиента
/transfers/send
Отправка перевода
Токен аутентификации, полученный при вызове сервиса авторизации
Токен клиента
200 OK
BadRequest
Unauthorized
Forbidden
Internal Server Error
/transfers/status
Сервис предназначен для получения информации о переводе
Токен аутентификации, полученный при вызове сервиса авторизации
Токен клиента
id документа
признак платежа в тенге
Определения
Структура выписки по счету.
{
"type": "object",
"properties": {
"info": {
"$ref": "#\/definitions\/StatementInfo"
},
"inBalance": {
"$ref": "#\/definitions\/BalanceInfo"
},
"outBalance": {
"$ref": "#\/definitions\/BalanceInfo"
},
"transactions": {
"type": "array",
"items": {
"$ref": "#\/definitions\/Transaction"
}
}
}
}
{
"type": "object",
"properties": {
"reference": {
"type": "string",
"example": "09301",
"description": "Референс"
},
"currency": {
"type": "string",
"example": "KZT",
"description": "Валюта выписки"
},
"accountBankCode": {
"type": "string",
"example": "KCJBKZKX",
"description": "БИК банка"
},
"accountNumber": {
"type": "string",
"example": "KZ100100100100100100",
"description": "Номер счёта"
},
"accountType": {
"type": "string",
"example": "CURR",
"description": "Тип счёта"
},
"accountName": {
"type": "string",
"example": "Счет",
"description": "Наименование счёта"
},
"accOwnerAddress": {
"type": "string",
"example": "050000, КАЗАХСТАН, АЛМАТЫ г",
"description": "Адрес клиента"
},
"bankBranchAddress": {
"type": "string",
"example": "050000, КАЗАХСТАН, АЛМАТЫ г",
"description": "Адрес отделения банка"
},
"bankBranchIdn": {
"type": "string",
"example": 100100100100,
"description": "БИН отделения банка"
},
"bankBranchBIC": {
"type": "string",
"example": "KCJBKZKX",
"description": "БИК отделения банка"
},
"lastStatementDate": {
"type": "string",
"example": "31-03-2020",
"format": "date",
"description": "Дата последней выписки"
},
"accOwnerCode": {
"type": "string",
"example": 17,
"description": "Код резиденства и сектора эконимики клиента"
},
"accOwnerIdn": {
"type": "string",
"example": 100100100100,
"description": "ИИН\/БИН клиента"
},
"accOwnerName": {
"type": "string",
"example": "Клиент",
"description": "Наименование клиента"
},
"bankBranchName": {
"type": "string",
"example": "Отделение",
"description": "Наименование отделения банка"
},
"bankBranchCode": {
"type": "string",
"example": "QQ1",
"description": "Код отделения банка"
},
"dateFrom": {
"type": "string",
"format": "date",
"example": "03-11-2020",
"description": "Дата начала периода"
},
"dateTo": {
"type": "string",
"format": "date",
"example": "03-11-2020",
"description": "Дата окончания периода"
},
"statementDateTime": {
"type": "string",
"format": "date-time",
"example": "23-02-2021 15:08:23",
"description": "Дата формирования выписки"
},
"payCountDebit": {
"type": "number",
"example": 55,
"description": "Количество транзакций по дебету"
},
"payCountCredit": {
"type": "number",
"example": 22,
"description": "Количество транзакции по кредиту"
},
"turnoverDebit": {
"type": "number",
"example": 694210.33,
"description": "Обороты по дебету"
},
"turnoverCredit": {
"type": "number",
"example": 694210.44,
"description": "Обороты по кредиту"
},
"turnover": {
"type": "number",
"example": 6941110.33,
"description": "Обороты"
},
"eqTurnover": {
"type": "number",
"example": 69422.33,
"description": "Обороты в эквиваленте"
}
}
}
{
"type": "object",
"properties": {
"date": {
"type": "string",
"example": "03-11-2020",
"format": "date",
"description": "Дата баланса"
},
"currency": {
"type": "string",
"example": "USD",
"description": "Валюта"
},
"rate": {
"type": "number",
"example": 1,
"description": "Курс"
},
"amount": {
"type": "number",
"example": 1543405.45,
"description": "Баланс в валюте"
},
"eqAmount": {
"type": "number",
"example": 1543405.45,
"description": "Баланс в эквиваленте"
}
}
}
{
"type": "object",
"properties": {
"paymentId": {
"type": "string",
"example": 10002282217111,
"description": "Идентификатор транзакции"
},
"docNumber": {
"type": "string",
"example": 175,
"description": "Номер документа"
},
"valueDate": {
"type": "string",
"example": "04-02-2020",
"format": "date",
"description": "Дата валютирования"
},
"entryDate": {
"type": "string",
"example": "04-02-2020",
"format": "date",
"description": "Операционный день"
},
"execdate": {
"type": "string",
"example": "23-02-2021 15:08:23",
"format": "date-time",
"description": "Дата\/Время исполнения"
},
"createDate": {
"type": "string",
"example": "23-02-2021 15:08:23",
"format": "date-time",
"description": "Дата\/Время ввода в систему"
},
"dbcrfl": {
"type": "string",
"example": 1,
"description": "Направление транзакции (1-дебет, 0-кредит)"
},
"amount": {
"type": "number",
"example": 154655.73,
"format": "float",
"description": "Сумма транзакции"
},
"clientReference": {
"type": "string",
"example": 175,
"description": "Клиентский референс"
},
"bankReference": {
"type": "string",
"example": "ALM2020471551594",
"description": "Банковский референс"
},
"knp": {
"type": "string",
"example": 332,
"description": "Код назначения платежа"
},
"budgetCode": {
"type": "string",
"example": 142,
"description": "Код бюджетной классификации"
},
"partyCode": {
"type": "string",
"example": 14,
"description": "Резиденство и сектор экономики корреспондента"
},
"partyIdn": {
"type": "string",
"example": 100100100100,
"description": "ИИН\/Бин корреспондента"
},
"partyName": {
"type": "string",
"example": "Банк ЦентрКредит АО",
"description": "Наименование корреспондента"
},
"partyAccount": {
"type": "string",
"example": "KZ100100100100100100",
"description": "Счет корреспондента"
},
"partyBankCode": {
"type": "string",
"example": "KCJBKZKX",
"description": "БИК банка корреспондента"
},
"partyBankName": {
"type": "string",
"example": "АО \"Банк ЦентрКредит\"",
"description": "Наименование банка корреспондента"
},
"corrIdn": {
"type": "string",
"example": 180640010876,
"description": "ИИН\/БИН отправителя"
},
"corrName": {
"type": "string",
"example": "Наименование",
"description": "Наименование отправителя"
},
"purpose": {
"type": "string",
"example": "Для зачисления на картсчета сотрудникам",
"description": "Назначение платежа"
},
"eqAmount": {
"type": "string",
"example": 154655.73,
"description": "Сумма транзакции в эквиваленте"
},
"eqCurrency": {
"type": "string",
"example": "KZT",
"description": "Валюта эквивалента"
},
"chief": {
"type": "string",
"example": "Иванов И. И.",
"description": "Руководитель (1-я подпись)"
},
"mainbk": {
"type": "string",
"example": "Не предусмотрено",
"description": "Главный бухгалтер (2-я подпись)"
},
"stage": {
"type": "string",
"example": "FIN",
"description": "Состояние"
},
"period": {
"type": "string",
"example": 4,
"description": "Период оплаты (для платежей в бюджет)"
},
"clerk": {
"type": "string",
"example": "Иванов И. И.",
"description": "Исполнитель"
},
"poTypeDesc": {
"type": "string",
"example": "Платежное поручение",
"description": "Тип платежа"
},
"cardTrnAmount": {
"type": "string",
"description": "Сумма транзакции по карте"
},
"cardTrnCurr": {
"type": "string",
"description": "Валюта транзакции по карте"
},
"cardRRn": {
"type": "string"
},
"officialRate": {
"type": "string",
"description": "Учетный курс валюты транзакции"
},
"marketRate": {
"type": "string",
"description": "Рыночный курс валюты транзакции"
},
"registry": {
"$ref": "#\/definitions\/RegistryRecord"
}
}
}
Реестр платежа
{
"type": "object",
"properties": {
"assign": {
"type": "string",
"description": "Назначение"
},
"code": {
"type": "string",
"description": "Номер документа"
},
"dop": {
"type": "string",
"description": "Дата документа"
},
"dt": {
"type": "string",
"description": "Дата рождения"
},
"errCode": {
"type": "string",
"description": "Код ошибки"
},
"fm": {
"type": "string",
"description": "Фамилия"
},
"ft": {
"type": "string",
"description": "Отечество"
},
"knp": {
"type": "string",
"description": "Код назначения платежа"
},
"la": {
"type": "string",
"description": "Лицевой счет"
},
"nm": {
"type": "string",
"description": "Имя"
},
"nord": {
"type": "number"
},
"opv": {
"type": "string",
"description": "Идентификатор пенсионной проплаты"
},
"pendFl": {
"type": "number"
},
"period": {
"type": "string",
"description": "Период оплаты"
},
"rnn": {
"type": "string",
"description": "ИИН\/БИН"
},
"subRef": {
"type": "string",
"description": "Субреференс"
},
"sum": {
"type": "string",
"description": "Сумма"
}
}
}
{
"type": "object",
"properties": {
"account": {
"description": "Счёт",
"type": "string",
"example": "KZ128560000000517854"
},
"bik": {
"description": "БИК",
"type": "string",
"example": "GCVPKZ2A"
},
"code": {
"description": "Код",
"type": "string",
"example": "17"
},
"in": {
"description": "ИИН",
"type": "string",
"example": "940302300403"
},
"name": {
"description": "Имя",
"type": "string",
"example": "Имя"
}
},
"additionalProperties": false,
"required": [
"account",
"bik",
"code",
"in",
"name"
]
}
{
"properties": {
"amount": {
"type": "number",
"format": "double",
"description": "сумма платежа"
},
"clientCode": {
"type": "string",
"description": "Код клиента"
},
"commissionAccountNumber": {
"type": "string",
"description": "Счет спсиания комиссии",
"example": "KZ128560000000517854"
},
"currency": {
"type": "string",
"description": "Валюта",
"example": "KZT"
},
"customerId": {
"format": "int64",
"description": "Идентификатор владельца",
"type": "integer",
"example": 31234
},
"division": {
"type": "string",
"description": "Подразделение",
"example": "AF1"
},
"docDate": {
"type": "string",
"format": "date",
"description": "Дата документа",
"pattern": "dd-MM-yyyy",
"example": "01-01-2023"
},
"isUrgent": {
"type": "boolean",
"description": "Признак срочного платежа"
},
"knp": {
"type": "string",
"description": "КНП (Код назначения платежа)",
"example": "185"
},
"narrative_first": {
"description": "Произвольное назначение платежа, заполняется клиентом",
"type": "string",
"example": "Оплата пенсионных взносов за сотрудников"
},
"narrative": {
"description": "Назначение платежа",
"type": "string",
"example": "Единый платеж"
},
"signatureFirst": {
"type": "string",
"description": "Первый руководитель"
},
"signatureScheme": {
"type": "integer",
"format": "int32",
"description": "схема одобрения"
},
"signatureSecond": {
"type": "string",
"description": "Главный бухгалтер"
},
"state": {
"$ref": "#\/definitions\/State",
"description": "статус платежа"
},
"type": {
"type": "string",
"$ref": "#\/definitions\/TransferType",
"description": "Тип платежа",
"example": "SINGLE"
},
"valueDate": {
"type": "string",
"format": "date",
"description": "Дата валютирования",
"pattern": "dd-MM-yyyy",
"example": "01-01-2023"
},
"receiver": {
"$ref": "#\/definitions\/Participant"
},
"sender": {
"$ref": "#\/definitions\/Participant"
}
},
"additionalProperties": false,
"required": [
"sender",
"receiver",
"valueDate",
"type",
"state",
"signatureSecond",
"signatureScheme",
"signatureFirst",
"narrative_first",
"narrative",
"amount",
"clientCode",
"commissionAccountNumber",
"currency",
"customerId",
"division",
"docDate",
"isUrgent",
"knp"
]
}
{
"enum": [
"BUDGET",
"EXTERNAL",
"INTERNAL",
"MEDICAL",
"MEDICAL_REMAND",
"PENSION",
"SALARY",
"SINGLE",
"SOCIAL",
"STANDARD_CARD",
"STANDARD_CARD_BANK",
"VOLUNTARY_PENSION"
],
"type": "string"
}
{
"enum": [
"APPROVED",
"APPROVED_BANK",
"APPROVED_HALF",
"BANK_ACCEPTED",
"CONFIRMED",
"CREATED",
"DELETED",
"ERROR",
"EXECUTED",
"PRESENDED",
"SENDED"
],
"type": "string"
}
{
"type": "array",
"items": {
"$ref": "#\/definitions\/Account"
}
}
{
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "Идентификатор счета"
},
"iban": {
"type": "string",
"description": "Номер счета",
"example": "KZ128560000000517854"
},
"client_code": {
"type": "string",
"description": "Идентификатор клиента",
"example": "01253687"
},
"description": {
"type": "string",
"description": "Описание"
},
"name": {
"type": "string",
"description": "Название счета",
"example": "Текущий счет"
},
"currency": {
"type": "string",
"description": "Валюта",
"example": "KZT"
},
"status": {
"type": "string",
"description": "Статус",
"example": "OPENED"
},
"division": {
"type": "string",
"description": "Код отдела"
},
"type": {
"$ref": "#\/definitions\/AccountType",
"description": "Тип счета"
},
"is_main": {
"type": "boolean",
"description": "Признак основного счета"
}
},
"additionalProperties": false,
"required": [
"id",
"client_code",
"description",
"iban",
"name",
"currency",
"status",
"division",
"type",
"is_main"
]
}
{
"enum": [
"CURR",
"CARD"
],
"type": "string"
}
{
"type": "object",
"properties": {
"in": {
"type": "string",
"description": "ИИН\/БИН"
},
"name": {
"type": "string",
"description": "Наименование"
},
"account": {
"type": "string",
"description": "Номер счета"
},
"code": {
"type": "string",
"description": "КОд - код отправителя денег.\/ КБе - код получателя денег."
},
"country": {
"type": "string",
"description": "ISO код страны плательщика фактического получателя"
},
"intermediary": {
"type": "object",
"description": "Получатель бенефициар (посредник)"
},
"isThirdPartyPayment": {
"type": "boolean",
"description": "Признак платежа 3-му лицу (Фактический бенефициар)."
}
}
}
{
"type": "object",
"properties": {
"operation": {
"description": "Операция",
"type": "string",
"example": "Операция"
},
"birth_date": {
"format": "date",
"description": "Дата рождения",
"pattern": "dd-MM-yyyy",
"type": "string",
"example": "01-01-2023"
},
"surname": {
"description": "Фамилия",
"type": "string",
"example": "Фамилия"
},
"name": {
"description": "Имя",
"type": "string",
"example": "Имя"
},
"patronymic": {
"description": "Отчество",
"type": "string",
"example": "Отчество"
},
"account": {
"description": "Счёт",
"type": "string",
"example": "KZ80009EP00368609101"
},
"amount": {
"description": "Сумма фактическая за сотрудника",
"type": "number",
"example": 100
},
"estimatedAmount": {
"description": "Ожидаемая сумма оплаты за сотрудника",
"type": "number",
"example": 200
},
"knpList": {
"description": "Список КНП за которые производится оплата",
"type": "array",
"items": {
"type": "string"
},
"example": [
185,
191
]
},
"iin": {
"description": "ИИН",
"type": "string",
"example": "940302300403"
},
"period": {
"format": "date",
"description": "Период",
"pattern": "dd-MM-yyyy",
"type": "string",
"example": "01-01-2023"
},
"assign": {
"type": "string",
"description": "Назначение"
},
"economicSectorCode": {
"type": "string",
"description": "Код сектора экономики"
},
"isResident": {
"type": "boolean",
"description": "Признак резиденства"
},
"country": {
"type": "string",
"description": "Страна получателя ISO код страны по стандарту Alpha-2 ISO 3166-1"
}
}
}
{
"properties": {
"_id": {
"type": "string"
},
"_sub": {
"type": "string"
},
"archival": {
"type": "string"
},
"bank_name": {
"type": "string"
},
"code_bank": {
"type": "string"
},
"iban_code": {
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"comission_account": {
"description": "Счёт списания комиссии",
"type": "string",
"example": "KZ128560000000517854"
},
"amount": {
"description": "Сумма",
"type": "number",
"example": 0
},
"currency": {
"description": "Валюта",
"type": "string",
"example": "KZT"
},
"knp": {
"description": "КНП (Код назначения платежа)",
"type": "string",
"example": "185"
},
"taxcode": {
"description": "КБК",
"type": "string",
"example": "123"
},
"sender": {
"allOf": [
{
"$ref": "#\/definitions\/Subject"
},
{
"description": "Отправитель"
}
]
},
"receiver": {
"allOf": [
{
"$ref": "#\/definitions\/Subject"
},
{
"description": "Получатель"
}
]
},
"signatureA": {
"description": "Электронная подпись XML",
"type": "string",
"example": "XML с подписью NCA"
},
"signatureB": {
"description": "Электронная подпись XML",
"type": "string",
"example": "XML с подписью NCA"
},
"narrative_first": {
"description": "Произвольное назначение платежа, заполняется клиентом",
"type": "string",
"example": "Оплата пенсионных взносов за сотрудников"
},
"narrative": {
"description": "Назначение платежа",
"type": "string",
"example": "Единый платеж"
},
"type": {
"$ref": "#\/definitions\/TransferType",
"description": "Тип платежа",
"example": "SINGLE"
},
"period": {
"format": "date",
"description": "Период",
"pattern": "dd-MM-yyyy",
"type": "string",
"example": "01-01-2023"
},
"customer_id": {
"format": "int64",
"description": "Идентификатор владельца",
"type": "integer",
"example": 31234
},
"state": {
"$ref": "#\/definitions\/State",
"description": "Состояние(Статус) платежа",
"example": "CREATED"
},
"is_urgent": {
"description": "Признак срочного платежа",
"type": "boolean",
"example": false
},
"nds": {
"format": "int32",
"description": "НДС",
"type": "integer",
"example": 0
},
"employeeList": {
"$ref": "#\/definitions\/Employee",
"description": "Список сотрудников"
},
"detailList": {
"description": "Детали платежа",
"$ref": "#\/definitions\/TransferDetailDTO"
}
}
}
{
"type": "object",
"properties": {
"id": {
"format": "int64",
"description": "Идентификатор",
"type": "integer",
"example": 21324
},
"type": {
"type": "string",
"description": "Тип деталей"
},
"value": {
"description": "Значение - результат",
"type": "string"
}
}
}
{
"type": "object",
"properties": {
"processResult": {
"description": "Результат",
"$ref": "#\/definitions\/ProcessResult"
},
"count": {
"format": "int32",
"description": "Количество переводов",
"type": "integer",
"example": 0
},
"success": {
"format": "int32",
"description": "Признак успешности",
"type": "integer",
"example": 0
}
}
}
{
"properties": {
"content": {
"description": "Содержимое",
"$ref": "#\/definitions\/TransferResponse"
},
"pageNumber": {
"type": "string",
"description": "Номер страницы"
},
"pageSize": {
"type": "string",
"description": "Количество элементов на странице"
},
"totalElements": {
"type": "string",
"description": "Общее количество элементов"
},
"totalPage": {
"type": "string",
"description": "Количество страниц"
}
},
"additionalProperties": false
}
{
"type": "object",
"properties": {
"data": {
"description": "Список транзакций",
"type": "array",
"items": {
"type": "string",
"example": [
"123",
"321"
]
}
}
}
}
{
"properties": {
"id": {
"type": "integer",
"format": "int64",
"description": "Идентификатор платежа"
},
"docDate": {
"type": "string",
"description": "Дата документа"
},
"nDoc": {
"type": "string",
"description": "Номер документа"
},
"amount": {
"type": "integer",
"format": "int64",
"description": "Сумма платежа"
},
"currency": {
"type": "string",
"description": "Валюта платежа"
},
"narrative": {
"type": "string",
"description": "Назначение платежа"
},
"isKZT": {
"type": "boolean",
"description": "Признак платежа в тенге"
},
"timeSent": {
"type": "string",
"description": "Дата оправления документа"
},
"documentTypeId": {
"type": "integer",
"format": "int64",
"description": "Тип документа"
},
"timeParsed": {
"type": "string",
"description": "Дата платежа"
},
"receiverIdn": {
"type": "string",
"description": "ИИН\/БИН получаетля"
},
"receiverName": {
"type": "string"
}
},
"additionalProperties": false
}
{
"properties": {
"taxIdentificationNumber": {
"type": "string",
"description": "Номер налогоплательщика фактического бенефициара"
},
"isLegalEntity": {
"type": "boolean",
"description": "Признак юридического лица бенефициара"
},
"name": {
"type": "string",
"description": "Наименование фактического бенефициара в платеже"
},
"isResident3rd": {
"type": "string",
"description": "Признак резидента фактического получателя"
},
"country3rd": {
"type": "string",
"description": "ISO код страны по стандарту Alpha-2 ISO 3166-1 адреса регистрации фактического получателя"
}
},
"additionalProperties": false
}