Download OpenAPI specification:Download
Jusan Business API предназначен для создания интеграций между вашими информационными системами и сервисами Jusan Bank.
Перейдите в личный кабинет Jusan Business и в левом меню выберите пункт Jusan Business API.
Если у вас еще нет подключенного приложения, вы попадете на страницу с информацией об API. На ней нажмите “Подключить”.
В появившейся форме заполните информацию о вашем приложении и выберите, какой функционал должен быть доступен данному приложению.
Внимание: Если вы в последствии захотите изменить набор доступных приложению прав доступа, необходимо будет сгенерировать новые client_id и client_secret, используемые для авторизации.
После успешного сохранения данных о приложении, вы увидите окно с технической информацией, которую необходимо передать разработчикам.
Внимание: Не закрывайте окно прежде чем скопируете данные оттуда. Посмотреть повторно client_id и client_secret не получится. Но всегда можно будет сгенерировать новые, для уже созданного приложения.
После копирования авторизационных данных закройте окно.
Передайте client_id и client_secret вашим разработчикам вместе со ссылкой на данную документацию.
Вы можете отправлять суммарно до 50 запросов в минуту со всех приложений, подключенных к вашей компании. Если вы превысите количество запросов, методы начнут возвращать ошибку с кодом 429. В этом случае необходимо подождать 60 секунд и продолжить отправку запросов.
Все ошибки приходят в стандартном формате.
{
"code": "attempts_limit",
"description": "Attempt limit exceeded for the operation",
"timestamp": "2020-04-17T09:50:05.234"
}
В поле code
приходит уникальный код ошибки, который можно использовать для локализации или обработки альтернативных сценариев.
HTTP-статус 400 используется в случае возникновения проблем разбора входящего запроса: неверные аргументы метода или не пройдена базовая валидация на тип аргументов.
HTTP-статус 401 используется в случае возникновения ошибки аутентификации или авторизации и, как правило, означает проблему на стороне клиента.
HTTP-статус 404 используется в случае, если вызван несуществующий эндпоинт.
HTTP-статус 412 используется в случае возникновения ошибки краевого сценария, уникальный код также придет в поле code
.
HTTP-статус 429 используется в случае превышения количества запросов к API для одной компании.
HTTP-статус 500 используется в случае, если произошла непредвиденная ошибка на сервере.
Все code
и HTTP-статусы, которые явно не указаны в спецификации к методу, стоит обрабатывать как «что-то пошло не так».
Песочница представляет собой среду разработки и тестирования, которая позволяет разработчикам создавать и проверять функциональность своих приложений, связанных с Jusan Business API, в контролируемой и изолированной среде. Эта платформа обеспечивает безопасное и эффективное взаимодействие с банковскими сервисами, минимизирует риски и обеспечивает надежность при разработке и интеграции банковских API.
Для песочницы действуют все доступы подключаемые при создании приложения. Фунционал песочницы позволяет вам безопасно тестировать все доступные методы, но ограничивается предоставлением подготовленных данных на отправляемые запросы к ней.
Для авторизации и получения токена в песочнице используйте client_id_test, client_secret_test. Получаемый companyId используйте для запросов в песочницу.
В случае возникновения вопросов и предложений по работе Jusan Business API вы можете направлять их на почту: APIhelp@jusan.kz.
При регистрации приложения вы получили Client_ID и Client_Secret, которые необходимо использовать в запросе для аутентификации вашего приложения и получения авторизационного токена.
Полученный токен необходимо передавать во всех запросах к API в заголовке Authorization
, добавляя Bearer
перед значением токена.
Authorization: Bearer d25c16a1-ef1f-4da9-90af-292f525a54c9
Авторизационный токен имеет время жизни, по истечении которого необходимо получить новый токен, используя тот же запрос.
В ответе на запрос аутентификации кроме токена возвращается идентификатор компании, к которой подключено приложение: companyId
. Он должен быть передан как входной параметр в некоторых запросах.
Возвращает токен для зарегистрированного приложения компании.
Для запроса к песочнице:
Используйте client_id_test, client_secret_test и получаемые companyId, accessToken для следующих запросов в песочницу.
clientId | string Уникальный идентификатор зарегистрированного приложения компании |
clientSecret | string Секретный ключ зарегистрированного приложения компании |
{- "clientId": "83a577f2-6df1-4b87-a448-85af410a1569",
- "clientSecret": "QFBVY37Gj-caoJhSm_D2fdgzhOYxbwZbsSxYmLbKdhw"
}
{- "accessToken": "74139200-5de2-4339-a168-49afcb53bce9",
- "expiresIn": 3600,
- "tokenType": "Bearer",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb"
}
Получить информацию о текущих расчетных и депозитных счетах компании по идентификатору компании.
Для запроса к песочнице:
Используйте ранее полученные companyId, accessToken. Результатом успешного запроса на получение списка счетов будет являться ответ содержащий 2 счета.
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
{- "id": "83a577f2-6df1-4b87-a448-85af410a1569",
- "iban": "KZ76998KTB0001630460",
- "accountType": "ACCOUNT",
- "status": "OPENED",
- "balance": {
- "amount": "12000",
- "currency": "KZT"
}, - "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "openDate": "2019-08-24",
- "irreducibleBalance": 0
}
Доступны только по счетам с типом ACCOUNT. Возвращает выписку за нужный период в формате json.
В случае валютной операции в ответе после параметра amount будет дополнительно передаваться параметр amountLCY, представляющий перерасчёт суммы операции на KZT по указанному exchangeRate2.
В отличие от выписки по дате исполнения, выборка транзакций производится по дате операционного банковского дня, за который проведена финансовая операция. Ответ по выписке содержит в себе информацию о пагинации за весь запрашиваемый период.
Для запроса к песочнице:
Используйте ранее полученный companyId. В качестве iban используйте счет в KZT - KZ11111AAA1111111111 либо в USD - KZ11111BBB1111111111.
В качестве дополнительных параметров (фильтров) используйте специально предопределенные значения, указанные ниже.
В текущей реализации песочницы, запрос может содержать не более одного дополнительного параметра (кроме пар page+pageSize и amountFrom+amountTo, которые необходимо использовать вместе). Результатом успешного запроса будет являться ответ, содержащий определенное количество транзакций, соответствующих указанному фильтру.
При передаче любых альтернативных параметров dateFrom и/или dateTo, результатом успешного запроса будет являться ответ, не содержащий транзакций.
Параметры запроса для счета в тенге (KZT):
"dateFrom" = "2022-10-22" (обязательный)
"dateTo" = "2022-10-30" (обязательный)
"type" = "DEBIT or CREDIT"
"amountFrom" = "4000"
"amountTo" = "240000"
"documentNumber" = "449"
"page" = "1"
"pageSize" = "3"
"correspondentBin" = "098765432109"
"correspondentAccount" = "KZ88888LDB7778888777"
Параметры запроса для счета в валюте (USD):
"dateFrom" = "2022-04-01" (обязательный)
"dateTo" = "2022-10-01" (обязательный)
"type" = "DEBIT or CREDIT"
"amountFrom" = "27000"
"amountTo" = "37000"
"documentNumber" = "41"
"page" = "2"
"pageSize" = "2"
"correspondentBin" = "070707070707"
"correspondentAccount" = "KZ12313KKK1616161515"
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
iban | string <string> Example: KZ76998KTB0001630460 Уникальный идентификатор счета |
type | string Enum: "DEBIT" "CREDIT" Параметр, который определяет тип операции. Принимает значения "DEBIT" или "CREDIT". |
documentNumber | string Номер документа, транзакции по которому должны попасть в выписку |
correspondentBin | string IDN номер аккаунтов, транзакции по которым должны попасть в выписку |
correspondentAccount | string IBAN аккаунтов, транзакции по которым должны попасть в выписку |
dateFrom required | string <date> Дата начала периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+6). |
dateTo required | string <date> Дата окончания периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+6). Период между датой окончания и датой начала не должен превышать 365 дней. |
amountFrom | number <double> Указывается ограничение снизу на сумму транзакций, которые попадут в выписку |
amountTo | number <double> Указывается ограничение сверху на сумму транзакций, которые попадут в выписку |
page required | integer Default: 1 Номер страницы для пагинации результатов. Указывает номер запрашиваемой страницы. |
pageSize required | integer [ 1 .. 200 ] Default: 100 Размер страницы для пагинации результатов. Определяет количество операций на одной странице. |
{- "iban": "KZ76998KTB0001630460",
- "statementDate": "2023-08-10T13:32:27.103258",
- "dateFrom": "2022-10-07",
- "dateTo": "2022-10-20",
- "transactions": [
- {
- "id": "6444abc55556666677b95a49",
- "iban": "KZ76998KTB0001630460",
- "reference": "7722K19193388770",
- "documentNumber": "445",
- "correspondentBankBic": "TSESKZKA",
- "correspondentBankName": "Товарищество с ограниченной ответственностью \"Example Company\"",
- "correspondentAccount": "KZ22222S000000008181",
- "correspondentName": "Товарищество с ограниченной ответственностью \"Example Company\"",
- "kbe": {
- "code": "17",
- "name": ""
}, - "correspondentBin": "131040000000",
- "debit": {
- "amount": "12000",
- "currency": "KZT"
}, - "credit": {
- "amount": "12000",
- "currency": "KZT"
}, - "description": "Включая НДС = 11 785,71 ₸. Платежи за товары, за исключением недвижимости и товаров с КНП 711, 712 и 713.",
- "operDate": "2022-10-19",
- "executionDate": "2022-10-19T15:23:43",
- "valueDate": "2022-10-19",
- "knp": {
- "code": "710",
- "name": ""
}, - "kbk": {
- "code": "string",
- "name": "string"
}, - "signHead": "Иванов Иван",
- "signBuch": "Не предусмотрено",
- "type": "DEBIT",
- "amount": "110000",
- "amountLCY": 0,
- "amountVat": 0,
- "parentReference": "",
- "externalId": "400",
- "paymentColvirId": "400_0000000000",
- "category": "TRANSFER",
- "exchangeRate2": "Справочно: учетный курс НБРК на 19.10.22 0/0",
- "kursIsp": ""
}
], - "paginationInfo": {
- "pageNumber": 1,
- "pageSize": 1,
- "totalCount": 100,
- "pageCount": 1
}
}
Доступны только по счетам с типом ACCOUNT. Возвращает выписку за нужный период в формате json.
В случае валютной операции в ответе после параметра amount будет дополнительно передаваться параметр amountLCY, представляющий перерасчёт суммы операции на KZT по указанному exchangeRate2.
Для запроса к песочнице:
Используйте ранее полученный companyId. В качестве iban используйте счет в KZT - KZ11111AAA1111111111 либо в USD - KZ11111BBB1111111111. В качестве дополнительных параметров (фильтров) используйте специально предопределенные значения, указанные ниже.
В текущей реализации песочницы, запрос может содержать не более одного дополнительного параметра (кроме пар page+pageSize и amountFrom+amountTo, которые необходимо использовать вместе). Результатом успешного запроса будет являться ответ, содержащий определенное количество транзакций, соответствующих указанному фильтру.
При передаче любых альтернативных параметров executionDateFrom и/или executionDateTo, результатом успешного запроса будет являться ответ, не содержащий транзакций.
Параметры запроса для счета в тенге (KZT):
"executionDateFrom" = "2022-10-22T00:00:00" (обязательный)
"executionDateTo" = "2022-10-30T00:00:00" (обязательный)
"type" = "DEBIT or CREDIT"
"amountFrom" = "4000"
"amountTo" = "240000"
"documentNumber" = "449"
"page" = "1"
"pageSize" = "3"
"correspondentBin" = "098765432109"
"correspondentAccount" = "KZ88888LDB7778888777"
Параметры запроса для счета в валюте (USD):
"executionDateFrom" = "2022-04-01T00:00:00" (обязательный)
"executionDateTo" = "2022-10-01T00:00:00" (обязательный)
"type" = "DEBIT or CREDIT"
"amountFrom" = "27000"
"amountTo" = "37000"
"documentNumber" = "41"
"page" = "2"
"pageSize" = "2"
"correspondentBin" = "070707070707"
"correspondentAccount" = "KZ12313KKK1616161515"
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
iban | string <string> Example: KZ76998KTB0001630460 Уникальный идентификатор счета |
type | string Enum: "DEBIT" "CREDIT" Параметр, который определяет тип операции. Принимает значения "DEBIT" или "CREDIT". |
documentNumber | string Номер документа, транзакции по которому должны попасть в выписку |
correspondentBin | string IDN номер аккаунтов, транзакции по которым должны попасть в выписку |
correspondentAccount | string IBAN аккаунтов, транзакции по которым должны попасть в выписку |
executionDateFrom required | string <date-time> Время начала периода, должен содержать дату и время в часовом поясе Алматы (GMT+6) |
executionDateTo required | string <date-time> Время окончания периода, должен содержать дату и время в часовом поясе Алматы (GMT+6). Период между датой окончания и датой начала не должен превышать 365 дней или быть меньше 1 минуты. |
amountFrom | number <double> Указывается ограничение снизу на сумму транзакций, которые попадут в выписку |
amountTo | number <double> Указывается ограничение сверху на сумму транзакций, которые попадут в выписку |
page required | integer Default: 1 Номер страницы для пагинации результатов. Указывает номер запрашиваемой страницы. |
pageSize required | integer [ 1 .. 200 ] Default: 100 Размер страницы для пагинации результатов. Определяет количество операций на одной странице. |
{- "iban": "KZ76998KTB0001630460",
- "statementDate": "2023-08-10T13:32:27.103258",
- "dateFrom": "2022-10-07T00:00:00",
- "dateTo": "2022-10-20T00:00:00",
- "transactions": [
- {
- "id": "6444abc55556666677b95a49",
- "iban": "KZ76998KTB0001630460",
- "reference": "7722K19193388770",
- "documentNumber": "445",
- "correspondentBankBic": "TSESKZKA",
- "correspondentBankName": "Товарищество с ограниченной ответственностью \"Example Company\"",
- "correspondentAccount": "KZ22222S000000008181",
- "correspondentName": "Товарищество с ограниченной ответственностью \"Example Company\"",
- "kbe": {
- "code": "17",
- "name": ""
}, - "correspondentBin": "131040000000",
- "debit": {
- "amount": "12000",
- "currency": "KZT"
}, - "description": "Включая НДС = 11 785,71 ₸. Платежи за товары, за исключением недвижимости и товаров с КНП 711, 712 и 713.",
- "documentDate": "2022-10-19T12:23:43",
- "operDate": "2022-10-19",
- "executionDate": "2022-10-19T15:23:43",
- "valueDate": "2022-10-19",
- "knp": {
- "code": "710",
- "name": ""
}, - "signHead": "Иванов Иван",
- "signBuch": "Не предусмотрено",
- "type": "DEBIT",
- "amount": "110000",
- "amountLCY": 0,
- "amountVat": 0,
- "parentReference": "",
- "externalId": "400",
- "paymentColvirId": "400_0000000000",
- "category": "TRANSFER",
- "exchangeRate2": "Справочно: учетный курс НБРК на 19.10.22 0/0",
- "kursIsp": ""
}
], - "paginationInfo": {
- "pageNumber": 1,
- "pageSize": 1
}
}
Информация по пагинации - общая информация по списку транзакций за период времени.
Доступны только по счетам с типом ACCOUNT. Возвращает информацию по пагинации выписок за нужный период в формате json.
Результатом успешного запроса будет являться ответ, содержащий параметры фактического запроса и информация по пагинации, соответствующая указанному фильтру.
Для запроса к песочнице:
Используйте специально предопределенные значения, для всех параметров (такие же, как и для Получения выписки по дате исполнения кроме параметра “page”, который исключен).
В текущей реализации песочницы, запрос может содержать не более одного дополнительного параметра (кроме пары amountFrom+amountTo, которую необходимо использовать вместе).
Параметры запроса для счета в тенге (KZT), iban = KZ11111AAA1111111111:
"executionDateFrom" = "2022-10-22T00:00:00" (обязательный)
"executionDateTo" = "2022-10-30T00:00:00" (обязательный)
"type" = "DEBIT or CREDIT"
"amountFrom" = "4000"
"amountTo" = "240000"
"documentNumber" = "449"
"pageSize" = "3"
"correspondentBin" = "098765432109"
"correspondentAccount" = "KZ88888LDB7778888777"
Параметры запроса для счета в валюте (USD), iban = KZ11111BBB1111111111:
"executionDateFrom" = "2022-04-01T00:00:00" (обязательный)
"executionDateTo" = "2022-10-01T00:00:00" (обязательный)
"type" = "DEBIT or CREDIT"
"amountFrom" = "27000"
"amountTo" = "37000"
"documentNumber" = "41"
"pageSize" = "2"
"correspondentBin" = "070707070707"
"correspondentAccount" = "KZ12313KKK1616161515"
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
iban | string <string> Example: KZ76998KTB0001630460 Уникальный идентификатор счета |
type | string Enum: "DEBIT" "CREDIT" Параметр, который определяет тип операции. Принимает значения "DEBIT" или "CREDIT". |
documentNumber | string Номер документа, транзакции по которому должны быть подсчитаны в информации по пагинации |
correspondentBin | string IDN номер аккаунтов, транзакции по которым должны быть подсчитаны в информации по пагинации |
correspondentAccount | string IBAN аккаунтов, транзакции по которым должны быть подсчитаны в информации по пагинации |
executionDateFrom required | string <date-time> Время начала периода, должен содержать дату и время в часовом поясе Алматы (GMT+6) |
executionDateTo required | string <date-time> Время окончания периода, должен содержать дату и время в часовом поясе Алматы (GMT+6). Период между датой окончания и датой начала не должен превышать 365 дней или быть меньше 1 минуты. |
amountFrom | number <double> Указывается ограничение снизу на сумму транзакций, которые должны быть подсчитаны в информации по пагинации |
amountTo | number <double> Указывается ограничение сверху на сумму транзакций, которые должны быть подсчитаны в информации по пагинации |
pageSize required | integer [ 1 .. 200 ] Default: 100 Размер страницы в соответствии с которым должна быть рассчитана информация по пагинации. Определяет количество операций на одной странице. |
{- "iban": "KZ76998KTB0001630460",
- "statementDate": "2023-08-10T13:32:27.103258",
- "dateFrom": "2022-10-07T00:00:00",
- "dateTo": "2022-10-20T00:00:00",
- "paginationInfo": {
- "pageSize": 1,
- "totalCount": 100,
- "pageCount": 1
}
}
Получение сальдо по текущему счету на начало и конец указанного периода.
Для запроса к песочнице:
Используйте ранее полученные companyId, iban. Для параметров dateFrom, dateTo используйте предоставленные ниже значения.
При передаче указанных параметров запроса, результатом успешного запроса будет являться ответ содержащий параметры с определенными значениями. При передаче альтернативных параметров в запросе, результатом успешного запроса будет являться ответ содержащий параметры с нулевыми значениями.
Для счета в тенге:
"dateFrom": "2022-10-22"
"dateTo": "2022-10-30"
Для счета в валюте:
"dateFrom": "2022-08-01"
"dateTo"; "2022-10-01"
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
iban | string <string> Example: KZ76998KTB0001630460 Уникальный идентификатор счета |
dateFrom required | string <date> Поле должно содержать дату yyyy-mm-dd |
dateTo required | string <date> Поле должно содержать дату yyyy-mm-dd |
{- "iban": "KZ76998KTB0001630460",
- "statementDate": "2023-07-22",
- "dateFrom": "2022-10-22",
- "dateTo": "2022-10-30",
- "balanceIn": {
- "amount": "12000",
- "currency": "KZT"
}, - "balanceOut": {
- "amount": "12000",
- "currency": "KZT"
}, - "balanceInLCY": {
- "amount": "12000",
- "currency": "KZT"
}, - "balanceOutLCY": {
- "amount": "12000",
- "currency": "KZT"
}
}
Создайте черновик платежа, для того чтобы затем подписать его в личном кабинете вашей компании.
Для создания черновиков в песочнице: используйте ранее полученный companyId и передавайте значения соответствующие спецификации в тело запроса. Результатом успешного запроса на создание черновика будет являться ответ создающий черновик платежа, отражающего передаваемые параметры.
Создает черновик перевода между своими счетами
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
required | object Информация о получателе |
required | object Детальная информация |
{- "paymentRecipient": {
- "recipientAccount": {
- "iban": "KZ65432LTB0000123456"
}
}, - "details": {
- "payerIban": "KZ87654LTB0009879654",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "documentId": 177
}
}
{- "id": "1f5f7806-8951-4d89-8734-727f38b31cb2",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "status": {
- "code": "CREATED",
- "timestamp": "2023-06-18T19:23:38.284"
}, - "category": "DOMESTIC",
- "type": "IN_BETWEEN",
- "paymentRecipient": {
- "name": "Индивидуальный предприниматель «Name»",
- "iinOrBin": 790101010101,
- "kbe": {
- "code": "17",
- "name": ""
}, - "recipientAccount": {
- "iban": "KZ65432LTB0000123456",
- "bankName": "АО \"Jusan Bank\"",
- "bic": "TSESKZKA"
}
}, - "details": {
- "createDate": "2023-06-18T19:23:38.286",
- "knp": {
- "code": "710",
- "name": ""
}, - "description": "342 - Переводы клиентом денег с одного своего текущего счета, открытого в банке, на другой свой текущий счет, открытый в данном банке",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "vat": false,
- "urgent": false,
- "payerIban": "KZ87654LTB0009879654",
- "documentId": 177
}, - "signatureScheme": "SINGLE_SIGN",
- "userCanSignCustomSignature": false
}
Создает черновик платежа контрагенту
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
type required | string Enum: "INTERNAL" "EXTERNAL" Тип платежа |
category required | string Value: "DOMESTIC" Категория платежа |
required | object Информация о получателе |
required | object Детальная информация |
{- "type": "INTERNAL",
- "category": "DOMESTIC",
- "paymentRecipient": {
- "iinOrBin": 790101010101,
- "name": "Индивидуальный предприниматель «Name»",
- "kbe": {
- "code": "17",
- "name": 17
}, - "recipientAccount": {
- "iban": "KZ24998KTB0000104810",
- "bankName": "АО \"Jusan Bank\"",
- "bic": "TSESKZKA"
}
}, - "details": {
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "342",
- "name": "Переводы клиентом денег с одного своего текущего счета, открытого в банке, на другой свой текущий счет, открытый в данном банке"
}, - "description": "description",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "vat": true,
- "documentId": 177
}
}
{- "id": "1f5f7806-8951-4d89-8734-727f38b31cb2",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "status": {
- "code": "CREATED",
- "timestamp": "2023-06-18T19:23:38.284"
}, - "category": "DOMESTIC",
- "type": "INTERNAL",
- "paymentRecipient": {
- "name": "Индивидуальный предприниматель «Name»",
- "iinOrBin": 790101010101,
- "kbe": {
- "code": "17",
- "name": 17
}, - "recipientAccount": {
- "iban": "KZ24998KTB0000104810",
- "bankName": "АО \"Jusan Bank\"",
- "bic": "TSESKZKA"
}
}, - "details": {
- "createDate": "2023-06-18T18:39:49.489",
- "knp": {
- "code": "342",
- "name": "Переводы клиентом денег с одного своего текущего счета, открытого в банке, на другой свой текущий счет, открытый в данном банке"
}, - "description": "description",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "vat": false,
- "urgent": false,
- "payerIban": "KZ76998KTB0001630460",
- "documentId": 177,
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}
}, - "signatureScheme": "SINGLE_SIGN",
- "userCanSignCustomSignature": false
}
Создает черновик налогового платежа
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
required | object Информация о получателе |
required | object Детальная информация |
{- "paymentRecipient": {
- "iinOrBin": 141040004756,
- "name": "РГУ \"Комитет государственных доходов Министерства финансов\"",
- "recipientAccount": {
- "iban": "KZ24070105KSN0000000",
- "bankName": "РГУ \"Комитет казначейства Министерства финансов РК\"",
- "bic": "KKMFKZ2A"
}
}, - "details": {
- "associatedField": {
- "parameters": {
- "period": null,
- "periodStart": 5.2023,
- "periodEnd": 6.2023,
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "590",
- "name": "Прочие платежи"
}, - "kbk": {
- "code": "101201",
- "name": "Индивидуальный подоходный налог с доходов, облагаемых у источника выплаты"
}, - "description": "test",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 177
}
}
{- "id": "d42006a6-8e72-495b-9e6f-9b5ea1267d80",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "status": {
- "code": "CREATED",
- "timestamp": "2023-06-18T19:23:38.284"
}, - "category": "DOMESTIC",
- "type": "TAX",
- "paymentRecipient": {
- "name": "РГУ \"Комитет государственных доходов Министерства финансов\"",
- "iinOrBin": 141040004756,
- "kbe": {
- "code": "11",
- "name": "example"
}, - "recipientAccount": {
- "iban": "KZ24070105KSN0000000",
- "bankName": "РГУ \"Комитет казначейства Министерства финансов РК\"",
- "bic": "KKMFKZ2A"
}
}, - "details": {
- "createDate": "2023-06-18T18:39:49.489",
- "knp": {
- "code": "590",
- "name": "Прочие платежи"
}, - "kbk": {
- "code": "101201",
- "name": "Индивидуальный подоходный налог с доходов, облагаемых у источника выплаты"
}, - "description": "Прочие платежи. Период : 05.2023 - 06.2023.",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "vat": false,
- "urgent": true,
- "payerIban": "KZ76998KTB0001630460",
- "documentId": 177,
- "associatedField": {
- "parameters": {
- "period": null,
- "periodStart": 5.2023,
- "periodEnd": 6.2023,
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}
}, - "signatureScheme": "SINGLE_SIGN",
- "userCanSignCustomSignature": false
}
Создает черновик пенсионного платежа
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
required | object Детальная информация |
required | Array of objects Список сотрудников к платежу |
{- "details": {
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "010",
- "name": "Обязательные пенсионные взносы"
}, - "description": "description",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 177
}, - "paymentEmployees": [
- {
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string",
- "period": "2023-06-01"
}
]
}
{- "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "status": {
- "code": "CREATED",
- "timestamp": "2023-06-18T19:23:38.284"
}, - "category": "DOMESTIC",
- "type": "PENSION",
- "paymentRecipient": {
- "name": "НАО \"Государственная корпорация «Правительство для граждан\"",
- "iinOrBin": 160440007161,
- "kbe": {
- "code": "11",
- "name": "name"
}, - "recipientAccount": {
- "iban": "KZ12009NPS0413609816",
- "bic": "GCVPKZ2A"
}
}, - "details": {
- "createDate": "2023-06-18T18:39:49.489",
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "010",
- "name": "Обязательные пенсионные взносы"
}, - "description": "test",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 177
}, - "paymentEmployees": [
- {
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string",
- "period": "2023-06-01"
}
], - "signatureScheme": "SINGLE_SIGN",
- "userCanSignCustomSignature": false
}
Создает черновик социального платежа
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
required | object Детальная информация |
required | Array of objects Список сотрудников к платежу |
{- "details": {
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "012",
- "name": "Обязательные социальные отчисления"
}, - "description": "description",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 177
}, - "paymentEmployees": [
- {
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string",
- "period": "2023-06-01"
}
]
}
{- "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "status": {
- "code": "CREATED",
- "timestamp": "2023-06-18T19:23:38.284"
}, - "category": "DOMESTIC",
- "type": "SOCIAL",
- "paymentRecipient": {
- "name": "НАО \"Государственная корпорация «Правительство для граждан\"",
- "iinOrBin": 160440007161,
- "kbe": {
- "code": "11",
- "name": "name"
}, - "recipientAccount": {
- "iban": "KZ12009NPS0413609816",
- "bic": "GCVPKZ2A"
}
}, - "details": {
- "createDate": "2023-06-18T18:39:49.489",
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "012",
- "name": "Обязательные социальные отчисления"
}, - "description": "test",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 175
}, - "paymentEmployees": [
- {
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string",
- "period": "2023-06-01"
}
], - "signatureScheme": "SINGLE_SIGN",
- "userCanSignCustomSignature": false
}
Создает черновик платежа в фонд медицинского страхования
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
required | object Детальная информация |
required | Array of objects Список сотрудников к платежу |
{- "details": {
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": 121,
- "name": "Отчисления на обязательное социальное медицинское страхование"
}, - "description": "description",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 177
}, - "paymentEmployees": [
- {
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string",
- "period": "2023-06-01"
}
]
}
{- "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "status": {
- "code": "CREATED",
- "timestamp": "2023-06-18T19:23:38.284"
}, - "category": "DOMESTIC",
- "type": "MEDICAL",
- "paymentRecipient": {
- "name": "НАО \"Государственная корпорация «Правительство для граждан\"",
- "iinOrBin": 160440007161,
- "kbe": {
- "code": 11,
- "name": "name"
}, - "recipientAccount": {
- "iban": "KZ12009NPS0413609816",
- "bic": "GCVPKZ2A"
}
}, - "details": {
- "createDate": "2023-06-18T18:39:49.489",
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": 121,
- "name": "Отчисления на обязательное социальное медицинское страхование"
}, - "description": "test",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 175
}, - "paymentEmployees": [
- {
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string",
- "period": "2023-06-01"
}
], - "signatureScheme": "SINGLE_SIGN",
- "userCanSignCustomSignature": false
}
Создает черновик социального платежа
companyId | string <uuid> Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb Уникальный идентификатор компании, к которой привязано приложение — клиент Jusan Business API. Получить идентификатор можно в запросе аутентификации. |
required | object Детальная информация |
required | Array of objects Список сотрудников к платежу |
required | object Информация о получателе |
{- "details": {
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "590",
- "name": "Прочие платежи"
}, - "description": "description",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 177
}, - "paymentEmployees": [
- {
- "iban": "KZ34998ARB0000075966",
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string"
}
], - "paymentRecipient": {
- "iinOrBin": 790101010101,
- "name": "Индивидуальный предприниматель «Name»",
- "kbe": {
- "code": "19"
}, - "recipientAccount": {
- "iban": "KZ34998ARB0000075966",
- "bic": "TSESKZKA"
}
}
}
{- "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
- "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
- "status": {
- "code": "CREATED",
- "timestamp": "2023-06-18T19:23:38.284"
}, - "category": "DOMESTIC",
- "type": "SALARY",
- "paymentRecipient": {
- "name": "НАО \"Государственная корпорация «Правительство для граждан\"",
- "iinOrBin": 160440007161,
- "kbe": {
- "code": "19",
- "name": "name"
}, - "recipientAccount": {
- "iban": "KZ12009NPS0413609816",
- "bic": "GCVPKZ2A"
}
}, - "details": {
- "createDate": "2023-06-18T18:39:49.489",
- "associatedField": {
- "parameters": {
- "signatureNoCommission": false,
- "paymentPurpose": "test"
}
}, - "knp": {
- "code": "590",
- "name": "Прочие платежи"
}, - "description": "test",
- "payerIban": "KZ76998KTB0001630460",
- "paymentAmount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "urgent": true,
- "documentId": 175
}, - "paymentEmployees": [
- {
- "iban": "KZ34998ARB0000075966",
- "amount": {
- "amount": 10.21,
- "currency": "KZT"
}, - "birthDate": "1999-03-14",
- "firstname": "Иван",
- "iin": 990314000000,
- "lastname": "Иванов",
- "middlename": "string"
}
], - "signatureScheme": "SINGLE_SIGN",
- "userCanSignCustomSignature": false
}
В данном разделе содержатся методы, с помощью которых вы можете получить информацию о кодах КНП и КБЕ, а также реквизиты банков Казахстана. Эта информация может быть использована при создании платежей.
Метод для получения список кодов, доступен всем созданным приложениям
code required | string Enum: "KBE" "KNP" "KBK" Код для получения доменных значений (возможные значения: КБЕ, КНП, КБК) |
[- {
- "code": "18",
- "name": "Центральное Правительство",
- "description": "Признак нерезидента"
}
]
Метод для получения списка банков, доступен всем созданным приложениям
[- {
- "bic": "ATYNKZKA",
- "bin": "980740000057",
- "cityName": null,
- "countryCode": null,
- "countryId": "efc671aa-3865-4fe1-9e9b-60ca5c8fa798",
- "id": "ac8f309e-7bb5-43a3-b672-0b882cb75643",
- "internationalName": "JSC 'ALTYN BANK' (SB OF CHINA CITIC BANK CORPORATION)",
- "name": "АО \"Altyn Bank\" (ДБ China Citic Bank Corporation Limited)"
}
]