Jusan Business
API docs by Redocly

Business API

Download OpenAPI specification:

Введение

Business API предназначен для создания интеграций между вашими информационными системами и сервисами банка.

Подключение Business API

  1. Перейдите в личный кабинет клиента и в левом меню выберите пункт Business API.

  2. Если у вас еще нет подключенного приложения, вы попадете на страницу с информацией об API. На ней нажмите “Подключить”.

  3. В появившейся форме заполните информацию о вашем приложении и выберите, какой функционал должен быть доступен данному приложению.

    Внимание: Если вы в последствии захотите изменить набор доступных приложению прав доступа, необходимо будет сгенерировать новые client_id и client_secret, используемые для авторизации.

  4. После успешного сохранения данных о приложении, вы увидите окно с технической информацией, которую необходимо передать разработчикам.

    Внимание: Не закрывайте окно прежде чем скопируете данные оттуда. Посмотреть повторно client_id и client_secret не получится. Но всегда можно будет сгенерировать новые, для уже созданного приложения.

  5. После копирования авторизационных данных закройте окно.

  6. Передайте client_id и client_secret вашим разработчикам вместе со ссылкой на данную документацию.

Новости, обновления и поддержка

Telegram канал для разработчиков и интеграторов. В нем вы найдете информацию об изменениях в API, новых функциях, технических требованиях и примерах интеграции.
В случае возникновения вопросов и предложений по работе Business API вы можете направлять их на почту: APIhelp@alataucitybank.kz.

Ограничение на количество запросов к API

Вы можете отправлять суммарно до 50 запросов в минуту со всех приложений, подключенных к вашей компании. Если вы превысите количество запросов, методы начнут возвращать ошибку с кодом 429. В этом случае необходимо подождать 60 секунд и продолжить отправку запросов.

Обработка ошибок в API

Все ошибки приходят в стандартном формате.

{
   "error": {
      "code": "gateway.payment.validation",
      "description": "invalid payment fields",
      "details": [
         {
            "@type": "business",
            "code": "operation.not_allowed",
            "message": "You are not allowed to perform this operation at the current stage."
         }
      ]
   }
}

В поле code приходит уникальный код ошибки, который можно использовать для локализации или обработки альтернативных сценариев.

Поле details — это массив, содержащий дополнительные сведения о конкретных ошибках, сгруппированных по типу

HTTP-статус 400 используется в случае возникновения проблем разбора входящего запроса: неверные аргументы метода или не пройдена базовая валидация на тип аргументов.

HTTP-статус 401 используется в случае возникновения ошибки аутентификации или авторизации и, как правило, означает проблему на стороне клиента.

HTTP-статус 404 используется в случае, если вызван несуществующий эндпоинт.

HTTP-статус 412 используется в случае возникновения ошибки краевого сценария.

HTTP-статус 424 используется в случае, когда запрошенное действие зависело от другого сервиса, и этот сервис вернул ошибку.

HTTP-статус 429 используется в случае превышения количества запросов к API для одной компании.

HTTP-статус 500 используется в случае, если произошла непредвиденная ошибка на сервере.

Все code и HTTP-статусы, которые явно не указаны в спецификации к методу, стоит обрабатывать как «что-то пошло не так».

Обработка ошибок на уровне Firewall

В некоторых случаях ваш запрос может быть заблокирован Firewall. Это происходит, если запрос выглядит подозрительным или нарушает установленные правила безопасности. В таком случае вы получите ответ в формате HTML.

Пример ответа:

<!DOCTYPE html
        PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" lang="">
<head>
    <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="TEXT/HTML; CHARSET=utf-8" />
    <title>Error</title>
</head>
<body>
<H2>Error</H2>
<table summary="Error" border="0" bgcolor="#FEEE7A" cellpadding="0" cellspacing="0" width="400">
    <tr>
        <td>
            <table summary="Error" border="0" cellpadding="3" cellspacing="1">
                <tr valign="top" bgcolor="#FBFFDF" align="left">
                    <td><STRONG>Error</STRONG></td>
                </tr>
                <tr valign="top" bgcolor="#FFFFFF">
                    <td>This page can't be displayed. Contact support for additional
                        information.<br/>The incident ID is: N/A.</td>
                </tr>
            </table>
        </td>
    </tr>
</table>
</body>
</html>

Песочница

Песочница представляет собой среду разработки и тестирования, которая позволяет разработчикам создавать и проверять функциональность своих приложений, связанных с Business API, в контролируемой и изолированной среде. Эта платформа обеспечивает безопасное и эффективное взаимодействие с банковскими сервисами, минимизирует риски и обеспечивает надежность при разработке и интеграции банковских API.

Для песочницы действуют все доступы подключаемые при создании приложения. Фунционал песочницы позволяет вам безопасно тестировать все доступные методы, но ограничивается предоставлением подготовленных данных на отправляемые запросы к ней.

Для авторизации и получения токена в песочнице используйте client_id_test, client_secret_test. Получаемый companyId используйте для запросов в песочницу.

Аутентификация и авторизация

При регистрации приложения вы получили Client_ID и Client_Secret, которые необходимо использовать в запросе для аутентификации вашего приложения и получения авторизационного токена.

Использование токена

Полученный токен необходимо передавать во всех запросах к API в заголовке Authorization, добавляя Bearer перед значением токена.

Пример

Authorization: Bearer d25c16a1-ef1f-4da9-90af-292f525a54c9

Обновление токена

Авторизационный токен имеет время жизни, по истечении которого необходимо получить новый токен, используя тот же запрос.

Идентификатор компании

В ответе на запрос аутентификации кроме токена возвращается идентификатор компании, к которой подключено приложение: companyId. Он должен быть передан как входной параметр в некоторых запросах.

Получить авторизационный токен

Возвращает токен для зарегистрированного приложения компании.

Для запроса к песочнице:
Используйте client_id_test, client_secret_test и получаемые companyId, accessToken для следующих запросов в песочницу.

Request Body schema: application/json
required
clientId
string

Уникальный идентификатор зарегистрированного приложения компании

clientSecret
string

Секретный ключ зарегистрированного приложения компании

Responses

Request samples

Content type
application/json
{
  • "clientId": "83a577f2-6df1-4b87-a448-85af410a1569",
  • "clientSecret": "QFBVY37Gj-caoJhSm_D2fdgzhOYxbwZbsSxYmLbKdhw"
}

Response samples

Content type
application/json
{
  • "accessToken": "74139200-5de2-4339-a168-49afcb53bce9",
  • "expiresIn": 3600,
  • "tokenType": "bearer",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb"
}

Информация по счетам

Получайте актуальную информацию о счетах своей компании с помощью API.

Получить список счетов компании

Получить информацию о текущих расчетных и депозитных счетах компании по идентификатору компании.

Для запроса к песочнице:
Используйте ранее полученные companyId, accessToken. Результатом успешного запроса на получение списка счетов будет являться ответ содержащий 2 счета.

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Responses

Response samples

Content type
application/json
{
  • "iban": "KZ76998KTB0001630460",
  • "accountType": "ACCOUNT",
  • "status": "OPENED",
  • "balance": {
    },
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "openDate": "2019-08-24",
  • "irreducibleBalance": 0
}

Выписки

Получайте выписку за нужный период с помощью API.

Получить выписку по счету v3

Доступны только по счетам с типом ACCOUNT. Возвращает выписку за нужный период в формате json.
В случае валютной операции в ответе после параметра amount будет дополнительно передаваться параметр amountLCY, представляющий перерасчёт суммы операции на KZT по указанному exchangeRate2.

Для запроса к песочнице:

Параметры запроса для счета в тенге (KZT):

"iban" = "KZ11111AAA1111111111" (обязательный)
"dateFrom" = "2025-03-03" (обязательный)
"dateTo" = "2025-03-11" (обязательный)
"page" = "1"
"pageSize" = "3"

Параметры запроса для счета в валюте (USD):

"iban" = "KZ11111BBB1111111111" (обязательный)
"dateFrom" = "2025-03-03" (обязательный)
"dateTo" = "2025-03-11" (обязательный)
"page" = "2"
"pageSize" = "2"

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

query Parameters
iban
required
string

Номер счета

dateFrom
required
string <date>

Дата начала периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+5).

dateTo
required
string <date>

Дата окончания периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+5). Период между датой окончания и датой начала не должен превышать 92 дней.

page
integer
Default: 1

Номер страницы для пагинации результатов. Указывает номер запрашиваемой страницы.

pageSize
integer [ 1 .. 200 ]
Default: 100

Размер страницы для пагинации результатов. Определяет количество операций на одной странице.

Responses

Response samples

Content type
application/json
Example
{
  • "iban": "KZ76998KTB0001630460",
  • "statementDate": "2023-08-10T13:32:27.103258",
  • "dateFrom": "2022-10-07",
  • "dateTo": "2022-10-20",
  • "balanceIn": {
    },
  • "balanceOut": {
    },
  • "balanceInLCY": {
    },
  • "balanceOutLCY": {
    },
  • "debitTotalSum": {
    },
  • "creditTotalSum": {
    },
  • "transactions": [
    ],
  • "paginationInfo": {
    }
}

Получить выписку по счету v2

Важно Важно:

Данный метод устарел и больше не развивается.

Используйте новый метод Получить выписку по счету v3 — его поддержка актуальна. О дате отключения сообщим дополнительно в Telegram-канале .

Доступны только по счетам с типом ACCOUNT. Возвращает выписку за нужный период в формате json.
В случае валютной операции в ответе после параметра amount будет дополнительно передаваться параметр amountLCY, представляющий перерасчёт суммы операции на KZT по указанному exchangeRate2.
В отличие от выписки по дате исполнения, выборка транзакций производится по дате операционного банковского дня, за который проведена финансовая операция. Ответ по выписке содержит в себе информацию о пагинации за весь запрашиваемый период.

Для запроса к песочнице:
Используйте ранее полученный companyId. В качестве дополнительных параметров (фильтров) используйте специально предопределенные значения, указанные ниже. Результатом успешного запроса будет являться ответ, содержащий определенное количество транзакций, соответствующих указанному фильтру.

Параметры запроса для счета в тенге (KZT):

"iban" = "KZ11111AAA1111111111" (обязательный)
"dateFrom" = "2025-03-03" (обязательный)
"dateTo" = "2025-03-11" (обязательный)
"page" = "1"
"pageSize" = "3"

Параметры запроса для счета в валюте (USD):

"iban" = "KZ11111BBB1111111111" (обязательный)
"dateFrom" = "2025-03-03" (обязательный)
"dateTo" = "2025-03-11" (обязательный)
"page" = "2"
"pageSize" = "2"

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

query Parameters
iban
required
string

Номер счета

dateFrom
required
string <date>

Дата начала периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+5).

dateTo
required
string <date>

Дата окончания периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+5). Период между датой окончания и датой начала не должен превышать 92 дней.

page
required
integer
Default: 1

Номер страницы для пагинации результатов. Указывает номер запрашиваемой страницы.

pageSize
required
integer [ 1 .. 200 ]
Default: 100

Размер страницы для пагинации результатов. Определяет количество операций на одной странице.

Responses

Response samples

Content type
application/json
{
  • "iban": "KZ76998KTB0001630460",
  • "statementDate": "2023-08-10T13:32:27.103258",
  • "dateFrom": "2022-10-07",
  • "dateTo": "2022-10-20",
  • "transactions": [
    ],
  • "paginationInfo": {
    }
}

Получить выписки по операционному дню

Важно Важно:

Данный метод устарел и больше не развивается.

Используйте новый метод Получить выписку по счету v3 — его поддержка актуальна. О дате отключения сообщим дополнительно в Telegram-канале .

Доступны только по счетам с типом 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"

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

iban
string <string>
Example: KZ76998KTB0001630460

Уникальный идентификатор счета

query Parameters
type
string
Enum: "DEBIT" "CREDIT"

Параметр, который определяет тип операции. Принимает значения "DEBIT" или "CREDIT".

documentNumber
string

Номер документа, транзакции по которому должны попасть в выписку

correspondentBin
string

IDN номер аккаунтов, транзакции по которым должны попасть в выписку

correspondentAccount
string

IBAN аккаунтов, транзакции по которым должны попасть в выписку

dateFrom
required
string <date>

Дата начала периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+5).

dateTo
required
string <date>

Дата окончания периода, в соответствии с операционным банковским днем проведения платежа. Содержит дату в соответствии с часовым поясом Алматы (GMT+5). Период между датой окончания и датой начала не должен превышать 365 дней.

amountFrom
number <double>

Указывается ограничение снизу на сумму транзакций, которые попадут в выписку

amountTo
number <double>

Указывается ограничение сверху на сумму транзакций, которые попадут в выписку

page
required
integer
Default: 1

Номер страницы для пагинации результатов. Указывает номер запрашиваемой страницы.

pageSize
required
integer [ 1 .. 200 ]
Default: 100

Размер страницы для пагинации результатов. Определяет количество операций на одной странице.

Responses

Response samples

Content type
application/json
{
  • "iban": "KZ76998KTB0001630460",
  • "statementDate": "2023-08-10T13:32:27.103258",
  • "dateFrom": "2022-10-07",
  • "dateTo": "2022-10-20",
  • "transactions": [
    ],
  • "paginationInfo": {
    }
}

Получить выписки по дате исполнения

Важно Важно:

Данный метод устарел и больше не развивается.

Используйте новый метод Получить выписку по счету v3 — его поддержка актуальна. О дате отключения сообщим дополнительно в Telegram-канале .

Доступны только по счетам с типом 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"

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

iban
string <string>
Example: KZ76998KTB0001630460

Уникальный идентификатор счета

query Parameters
type
string
Enum: "DEBIT" "CREDIT"

Параметр, который определяет тип операции. Принимает значения "DEBIT" или "CREDIT".

documentNumber
string

Номер документа, транзакции по которому должны попасть в выписку

correspondentBin
string

IDN номер аккаунтов, транзакции по которым должны попасть в выписку

correspondentAccount
string

IBAN аккаунтов, транзакции по которым должны попасть в выписку

executionDateFrom
required
string <date-time>

Время начала периода, должен содержать дату и время в часовом поясе Алматы (GMT+5)

executionDateTo
required
string <date-time>

Время окончания периода, должен содержать дату и время в часовом поясе Алматы (GMT+5). Период между датой окончания и датой начала не должен превышать 365 дней или быть меньше 1 минуты.

amountFrom
number <double>

Указывается ограничение снизу на сумму транзакций, которые попадут в выписку

amountTo
number <double>

Указывается ограничение сверху на сумму транзакций, которые попадут в выписку

page
required
integer
Default: 1

Номер страницы для пагинации результатов. Указывает номер запрашиваемой страницы.

pageSize
required
integer [ 1 .. 200 ]
Default: 100

Размер страницы для пагинации результатов. Определяет количество операций на одной странице.

Responses

Response samples

Content type
application/json
{
  • "iban": "KZ76998KTB0001630460",
  • "statementDate": "2023-08-10T13:32:27.103258",
  • "dateFrom": "2022-10-07T00:00:00",
  • "dateTo": "2022-10-20T00:00:00",
  • "transactions": [
    ],
  • "paginationInfo": {
    }
}

Получить информацию по пагинации выписок по дате исполнения

Важно Важно:

Данный метод устарел и больше не развивается.

Используйте новый метод Получить выписку по счету v3 — его поддержка актуальна. О дате отключения сообщим дополнительно в Telegram-канале .

Информация по пагинации - общая информация по списку транзакций за период времени.

Доступны только по счетам с типом 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"

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

iban
string <string>
Example: KZ76998KTB0001630460

Уникальный идентификатор счета

query Parameters
type
string
Enum: "DEBIT" "CREDIT"

Параметр, который определяет тип операции. Принимает значения "DEBIT" или "CREDIT".

documentNumber
string

Номер документа, транзакции по которому должны быть подсчитаны в информации по пагинации

correspondentBin
string

IDN номер аккаунтов, транзакции по которым должны быть подсчитаны в информации по пагинации

correspondentAccount
string

IBAN аккаунтов, транзакции по которым должны быть подсчитаны в информации по пагинации

executionDateFrom
required
string <date-time>

Время начала периода, должен содержать дату и время в часовом поясе Алматы (GMT+5)

executionDateTo
required
string <date-time>

Время окончания периода, должен содержать дату и время в часовом поясе Алматы (GMT+5). Период между датой окончания и датой начала не должен превышать 365 дней или быть меньше 1 минуты.

amountFrom
number <double>

Указывается ограничение снизу на сумму транзакций, которые должны быть подсчитаны в информации по пагинации

amountTo
number <double>

Указывается ограничение сверху на сумму транзакций, которые должны быть подсчитаны в информации по пагинации

pageSize
required
integer [ 1 .. 200 ]
Default: 100

Размер страницы в соответствии с которым должна быть рассчитана информация по пагинации. Определяет количество операций на одной странице.

Responses

Response samples

Content type
application/json
{
  • "iban": "KZ76998KTB0001630460",
  • "statementDate": "2023-08-10T13:32:27.103258",
  • "dateFrom": "2022-10-07T00:00:00",
  • "dateTo": "2022-10-20T00:00:00",
  • "paginationInfo": {
    }
}

Получение сальдо счета

Получение сальдо по текущему счету на начало и конец указанного периода.

Для запроса к песочнице:
Используйте ранее полученные companyId, iban. Для параметров dateFrom, dateTo используйте предоставленные ниже значения.
При передаче указанных параметров запроса, результатом успешного запроса будет являться ответ содержащий параметры с определенными значениями. При передаче альтернативных параметров в запросе, результатом успешного запроса будет являться ответ содержащий параметры с нулевыми значениями.

Для счета в тенге:

"dateFrom": "2022-10-22"
"dateTo": "2022-10-30"

Для счета в валюте:

"dateFrom": "2022-08-01"
"dateTo"; "2022-10-01"

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

iban
string <string>
Example: KZ76998KTB0001630460

Уникальный идентификатор счета

query Parameters
dateFrom
required
string <date>

Поле должно содержать дату yyyy-mm-dd

dateTo
required
string <date>

Поле должно содержать дату yyyy-mm-dd

Responses

Response samples

Content type
application/json
{
  • "iban": "KZ76998KTB0001630460",
  • "statementDate": "2023-07-22",
  • "dateFrom": "2022-10-22",
  • "dateTo": "2022-10-30",
  • "balanceIn": {
    },
  • "balanceOut": {
    },
  • "balanceInLCY": {
    },
  • "balanceOutLCY": {
    }
}

Создание черновиков платежей

Создайте черновик платежа, для того чтобы затем подписать его в личном кабинете вашей компании.

Для создания черновиков в песочнице: используйте ранее полученный companyId и передавайте значения соответствующие спецификации в тело запроса. Результатом успешного запроса на создание черновика будет являться ответ создающий черновик платежа, отражающего передаваемые параметры.

Создать черновик перевода между своими текущими счетами

Создает черновик перевода между своими счетами

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
required
object

Информация о получателе

required
object

Детальная информация

Responses

Request samples

Content type
application/json
{
  • "paymentRecipient": {
    },
  • "details": {
    }
}

Response samples

Content type
application/json
{
  • "id": "1f5f7806-8951-4d89-8734-727f38b31cb2",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "IN_BETWEEN",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Создать черновик платежа контрагенту v2

Создает черновик платежа контрагенту

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
type
required
string
Enum Description
INTERNAL

Для платежа внутри банка
Значение поля bic = TSESKZKA, название Банка получателя bankName = АО "Alatau City Bank".

EXTERNAL

Для платежа в другой банк Казахстана
Значение поля bic не равно TSESKZKA, название Банка получателя bankName не равно АО "Alatau City Bank".

Тип платежа
Для INTERNAL, значение поля bic = TSESKZKA, название Банка получателя bankName = АО "ACB". Для EXTERNAL эти параметры могут принимать любые значения.

category
required
string
Value Description
DOMESTIC

Платежи в тенге

Категория платежа

required
object

Информация о получателе

required
object

Детальная информация

Responses

Request samples

Content type
application/json
{
  • "type": "INTERNAL",
  • "category": "DOMESTIC",
  • "paymentRecipient": {
    },
  • "details": {
    }
}

Response samples

Content type
application/json
{
  • "id": "90ae5d79-55c3-41d5-a3a6-f7dc1a598a2c",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "INTERNAL",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Создать черновик платежа контрагенту

Важно Важно:

Данный метод устарел и больше не развивается.

Используйте новый метод Создать черновик платежа контрагенту v2 — его поддержка актуальна. О дате отключения сообщим дополнительно в Telegram-канале .

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
type
required
string
Enum Description
INTERNAL

Для платежа внутри банка
Значение поля bic = TSESKZKA, название Банка получателя bankName = АО "Alatau City Bank".

EXTERNAL

Для платежа в другой банк Казахстана
Значение поля bic не равно TSESKZKA, название Банка получателя bankName не равно АО "Alatau City Bank".

Тип платежа
Может принимать одно и следующих значений:
INTERNAL для платежа внутри банка
EXTERNAL для платежа в другой банк Казахстана

Для INTERNAL, значение поля bic = TSESKZKA, название Банка получателя bankName = АО "ACB". Для EXTERNAL эти параметры могут принимать любые значения.

category
required
string
Value Description
DOMESTIC

Платежи в тенге

Категория платежа

required
object

Информация о получателе

required
object

Детальная информация

Responses

Request samples

Content type
application/json
{
  • "type": "INTERNAL",
  • "category": "DOMESTIC",
  • "paymentRecipient": {
    },
  • "details": {
    }
}

Response samples

Content type
application/json
{
  • "id": "1f5f7806-8951-4d89-8734-727f38b31cb2",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "INTERNAL",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Создать черновик налогового платежа

Создает черновик налогового платежа

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
required
object

Информация о получателе

required
object

Детальная информация

Responses

Request samples

Content type
application/json
{
  • "paymentRecipient": {
    },
  • "details": {
    }
}

Response samples

Content type
application/json
{
  • "id": "d42006a6-8e72-495b-9e6f-9b5ea1267d80",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "TAX",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Создать черновик пенсионного платежа

Создает черновик пенсионного платежа

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
required
object

Детальная информация

required
Array of objects

Список сотрудников к платежу

Responses

Request samples

Content type
application/json
{
  • "details": {
    },
  • "paymentEmployees": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "PENSION",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "paymentEmployees": [
    ],
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Создать черновик социального платежа

Создает черновик социального платежа

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
required
object

Детальная информация

required
Array of objects

Список сотрудников к платежу

Responses

Request samples

Content type
application/json
{
  • "details": {
    },
  • "paymentEmployees": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "SOCIAL",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "paymentEmployees": [
    ],
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Создать черновик платежа в фонд медицинского страхования

Создает черновик платежа в фонд медицинского страхования

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
required
object

Детальная информация

required
Array of objects

Список сотрудников к платежу

Responses

Request samples

Content type
application/json
{
  • "details": {
    },
  • "paymentEmployees": [
    ]
}

Response samples

Content type
application/json
{
  • "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "MEDICAL",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "paymentEmployees": [
    ],
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Создать черновик зарплатного платежа

Создает черновик зарплатного платежа

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
required
object

Детальная информация

required
Array of objects

Список сотрудников к платежу

required
object

Информация о получателе

Responses

Request samples

Content type
application/json
{
  • "details": {
    },
  • "paymentEmployees": [
    ],
  • "paymentRecipient": {
    }
}

Response samples

Content type
application/json
{
  • "id": "ac5b8a67-aef0-44a5-a7b2-364b4f38c764",
  • "companyId": "333a4b56-7d8e-90ab-12c3-a1b123456ddb",
  • "status": {
    },
  • "category": "DOMESTIC",
  • "type": "SALARY",
  • "paymentRecipient": {
    },
  • "details": {
    },
  • "paymentEmployees": [
    ],
  • "signatureScheme": "SINGLE_SIGN",
  • "userCanSignCustomSignature": false
}

Платежи и переводы

Важно Важно:

Методы по проведению платежей находятся на стадии пилотного тестирования и доступны ограниченному числу клиентов.

Если вы заинтересованы в подключении к пилоту, пожалуйста, свяжитесь с нами по адресу: APIhelp@alataucitybank.kz.

Методы предназначены для выполнения платежей и переводов, которые требуют подписания электронной цифровой подписью (ЭЦП) в формате JWS (JSON Web Signature).

Пошаговая инструкция по подписанию платежа приведена в Инструкции по использованию NCALayer.

Перевод между своими текущими счетами

Для создания платежа сформировать payload платежа по нижеприведенной структуре:

{
  "type": "IN_BETWEEN",
  "category": "DOMESTIC",
  "paymentRecipient": {
    "iban": "KZ65432LTB0000123456",
    "recipientAccount": {
      "iban": "KZ65432LTB0000123456"
    }
  },
  "details": {
    "payerIban": "KZ87654LTB0009879654",
    "paymentAmount": {
      "amount": 10.21,
      "currency": "KZT"
    },
    "documentId": "177"
  }
}
№ Параметр Тип данных Обязательность Описание
1 type string Да Тип платежа.

Значение: IN_BETWEEN – Перевод между своими счетами
2 category string Да Категория платежа.

Значение: DOMESTIC – Платежи в тенге
3 paymentRecipient object Да Информация о получателе
3.1 recipientAccount object Да Счет получателя
3.2 iban string Да Номер счета получателя.

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
4 details object Да Детальная информация
4.1 payerIban string Да Номер счета плательщика.

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
4.2 paymentAmount object Да Сумма платежа
4.2.1 amount number Да Сумма.

Больше 0, не более 1 000 000 000. Не превышает 2-х знаков после запятой
4.2.2 currency string Да Валюта.

Три заглавные буквы валюты. Должна проходить валидацию, соответствовать валюте двух счетов. Должно быть равно KZT
4.3 documentId string Да Номер документа плательщика.

При заполнении цифрами, не должен превышать 19 символов. При заполнении цифрами и буквами, не должен превышать 200 символов

Сформированный payload платежа подписать ЭЦП. Подробнее вы можете ознакомиться в Инструкции по использованию NCALayer.
Затем сформировать запрос к методу — Выполнить перевод между своими текущими счетами.

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
content
required
string <JWS, base64url-encoded>

Сведения о платеже, подписанные ЭЦП

Responses

Request samples

Content type
application/json
{
  • "content": "eyJzcGFuaWQiOiJhYzI0Mzg5OGE5ZjY2YjA0OWRhNjlmNmU1MmY0ZGExNTIyZTVhYzRiMTY2NzM1OWNkYmQ2YTY0M2EwMWM1ZWY1IiwiY3R5IjoiYXBwbGljYXRpb24vanNvbiIsInR5cCI6IkpPU0UiLCJhbGciOiJFQ0dPU1QzNDEwLTIwMTUtNTEyIiwidHMiOiIxNzU1Mjc1ODQwMzAzIiwieDVjIjpbIk1JSUV2RENDQkNTZ0F3SUJBZ0lRUU95MUJPa1Vxdys1NzBOb25KZnBsakFPQmdvcWd3NERDZ0VCQWdNQ0JRQXdSekVqTUNFR0ExVUVBd3dhVFhrZ1EyOXRjR0Z1ZVNCSmJuUmxjbTFsWkdsaGRHVWdRMEV4RXpBUkJnTlZCQW9NQ2sxNUlFTnZiWEJoYm5reEN6QUpCZ05WQkFZVEFrdGFNQjRYRFRJMU1EY3lNekEyTkRjeU1Wb1hEVEkyTURjeU16QTJORGN5TVZvd2dmWXhSekJGQmdOVkJBTU1QdENVMExqUmdOQzEwTHJSZ3RDKzBZRFF2dEN5SU5DVTBMalJnTkMxMExyUmd0QyswWUFnMEpUUXVOR0EwTFhRdXRHQzBMN1JnTkMrMExMUXVOR0hNUjB3R3dZRFZRUUVEQlRRbE5DNDBZRFF0ZEM2MFlMUXZ0R0EwTDdRc2pFWU1CWUdBMVVFQlJNUFNVbE9PRGd4TWpJeU1EVXdOVFEwTVFzd0NRWURWUVFHRXdKTFdqRW9NQ1lHQTFVRUNnd2YwS0xRbnRDZUlOQ2cwTDdRczlDd0lOQzRJTkNhMEw3UXY5R0wwWUxRc0RFWU1CWUdBMVVFQ3d3UFFrbE9NVEl3TnpRd01ERTBOelV5TVNFd0h3WURWUVFxREJqUWxOQzQwWURRdGRDNjBZTFF2dEdBMEw3UXN0QzQwWWN3Z2F3d0l3WUpLb01PQXdvQkFRSUNNQllHQ2lxRERnTUtBUUVDQWdFR0NDcUREZ01LQVFNREE0R0VBQVNCZ0NMZG51QVFDbW4vT3VkdDg2RXJwdTlBcnhRVVhvV21TRjc5Zzc1Q3p5dG9GVnFSVE1HdlJEWnlHMzNNc2ZQYTcxTTZhVnRVRW9DWTNQR1JaaGFqNmx3cFR1VnJLU1BkOGtFb002UlIzM1YvRXRmaktPUk5Eb2pzZUcvWTNxcm50R0FSUHpqajBDY1oxR21tYUFvV3F5aXJQRzJJaHN1cVg5RFBtbVNOZFNEcm80SUI2RENDQWVRd0h3WURWUjBqQkJnd0ZvQVVzU1p3YXdyUTZETENrdzRjVWN3SDk0Z3RENGt3SFFZRFZSME9CQllFRkJLUk5tWVovbDNlYW4yQ0sxNCt5ZUtPdkFaTk1BNEdBMVVkRHdFQi93UUVBd0lHd0RBb0JnTlZIU1VFSVRBZkJnZ3JCZ0VGQlFjREJBWUlLb01PQXdNRUFRSUdDU3FERGdNREJBRUNBVEE0QmdOVkhTQUVNVEF2TUMwR0JpcUREZ01EQWpBak1DRUdDQ3NHQVFVRkJ3SUJGaFZvZEhSd09pOHZjR3RwTG1kdmRpNXJlaTlqY0hNd2RRWUlLd1lCQlFVSEFRRUVhVEJuTUNnR0NDc0dBUVVGQnpBQmhoeG9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDI5amMzQXZNRHNHQ0NzR0FRVUZCekFDaGk5b2RIUndPaTh2ZEdWemRDNXdhMmt1WjI5MkxtdDZMMk5sY25RdmFXNTBaWEp0WldScFlYUmxYMk5oTG1ObGNqQS9CZ05WSFI4RU9EQTJNRFNnTXFBd2hpNW9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDJOeWJDOXBiblJsY20xbFpHbGhkR1ZmWTJFdVkzSnNNRUVHQTFVZExnUTZNRGd3TnFBMG9ES0dNR2gwZEhBNkx5OTBaWE4wTG5CcmFTNW5iM1l1YTNvdlkzSnNMMmx1ZEdWeWJXVmthV0YwWlY5allWOWtMbU55YkRBYkJnTlZIUkVFRkRBU2dSQjFjMlZ5UUdWNFlXMXdiR1V1WTI5dE1CWUdCaXFERGdNREJRUU1NQW9HQ0NxRERnTURBd0VCTUE0R0NpcUREZ01LQVFFQ0F3SUZBQU9CZ1FBdTJ6Wm5Oc0V5cTZta3NhcFIwMi8rbkFnWUVSN243Q3ZtMy9JUkdOZEVldFdldnppSHJONTZYWklWUTVqZmNGb0N3MzRJeVJuUVdNdzNyN2VCOFo2RWUvYkJUZzJjTmtwcUpnQ09WNjVFY3E0MG1INDdDYXJOSTlZMmhGcFg4L1cvNWNvOTBRRzNyNWNVMEg4bXEyN0o5VE5SV3RZWFBNdUJNQklJaWllS21BPT0iXX0.ewogICJjYXRlZ29yeSI6ICJET01FU1RJQyIsCiAgInR5cGUiOiAiSU5fQkVUV0VFTiIsCiAgInBheW1lbnRSZWNpcGllbnQiOiB7CiAgICAicmVjaXBpZW50QWNjb3VudCI6IHsKICAgICAgImliYW4iOiAiS1o2NTQzMkxUQjAwMDAxMjM0NTYiCiAgICB9CiAgfSwKICAiZGV0YWlscyI6IHsKICAgICJwYXllckliYW4iOiAiS1o4NzY1NExUQjAwMDk4Nzk2NTQiLAogICAgInBheW1lbnRBbW91bnQiOiB7CiAgICAgICJhbW91bnQiOiAxMC4yMSwKICAgICAgImN1cnJlbmN5IjogIktaVCIKICAgIH0sCiAgICAiZG9jdW1lbnRJZCI6IDE3NwogIH0KfQ.ngoF6swcMX0vlSeDKuvaRCVvWyX565HO1Sy-JHNiDSHxIN1S3fjrH0eUMJ7gqtWNIuBWI6jWHbIRFnTmH48xsmZgs_h2j13NpcYjgK9eiDLxI7dE-rxg2Zcw8YTNtlwro7mMoX9us81bwKzkQwSJzil4msHk-2FpS2I-vwmsXLQ"
}

Response samples

Content type
application/json
{
  • "type": "string",
  • "category": "string",
  • "payment": {
    }
}

Выполнить платеж контрагенту

Для создания платежа сформировать payload платежа по нижеприведенной структуре:

{
  "type": "INTERNAL",
  "category": "DOMESTIC",
  "paymentRecipient": {
    "recipientAccount": {
      "iban": "KZ189985TB0001485820",
      "bic": "TSESKZKA"
    },
    "iinOrBin": "string",
    "countryCode": null,
    "factualRecipient": {
      "iinOrBin": "string",
      "name": "string"
    },
    "kbe": {
      "code": "17",
      "name": "   "
    }
  },
  "details": {
    "knp": {
      "code": "855",
      "name": "Лизинг (текущая аренда)"
    },
    "description": "оплата за аренду спецтехники по счету на оплату 06 от 20.08.2025г Платежи по лизингу (текущая аренда).. Лизинг (текущая аренда)",
    "paymentAmount": {
      "amount": 1800.00,
      "currency": "KZT"
    },
    "vat": false,
    "urgent": false,
    "payerIban": "KZ949985TB0001485810",
    "documentId": "2",
    "permitRecord": null,
    "paymentPurpose": "оплата за аренду спецтехники по счету на оплату 06 от 20.08.2025г Платежи по лизингу (текущая аренда)."
  }
}
№ Параметр Тип данных Обязательность Описание
1. type string Да Тип платежа

INTERNAL - для платежа внутри банка
EXTERNAL - для платежа в другой банк Казахстана

Для INTERNAL значение поля bic = TSESKZKA, название банка получателя bankName = АО «ACB».
Для EXTERNAL эти параметры могут принимать любые значения
2. category string Да Категория платежа
Может принимать только значение DOMESTIC — Платежи в тенге
3. paymentRecipient object Да Информация о получателе
3.1. recipientAccount object Да Счёт получателя
3.1.1. iban string Да Номер счета получателя
Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
3.1.2. bic string Да БИК банка получателя
Содержит только 8 заглавных букв и цифр
3.2. iinOrBin string Да ИИН/БИН получателя
3.3. countryCode string Нет Код страны нерезидента РК
Если получатель — нерезидент РК, то поле countryCode является обязательным для заполнения
3.4. factualRecipient object Нет Фактический получатель
Поле является обязательным для заполнения, если данные получателя и фактического получателя денежных средств не совпадают.
В этом случае обязательно должны быть указаны БИН и наименование фактического получателя
3.4.1. iinOrBin string Нет ИИН или БИН фактического получателя
Может принимать только 12 цифровых символов
3.4.2. name string Нет Название организации/лица — фактического получателя
Может содержать только буквы и цифры. Не должен превышать 200 символов
3.5. kbe object Да Сведения о КБЕ
3.5.1. code string Да Код КБЕ
Для корректности заполнения по данному параметру используйте методы из справочника
3.5.2. name string Да Наименование КБЕ
4. details object Да Детальная информация
4.1. knp object Да КНП
Для корректности заполнения по данному параметру используйте методы из справочника
4.1.1. code string Да Код КНП
Содержит только 3 цифры
4.1.2. name string Нет Название кода КНП
Может содержать буквы и цифры. Не должен превышать 200 символов
4.3. description string Да Назначение платежа
Может принимать буквы и цифры. Не должен превышать 482 символов
4.4. paymentAmount object Да Сумма платежа
4.4.1. amount number Да Сумма
Сумма больше 0, не больше 1 000 000 000 000. Не превышает 2-ух знаков после запятой
4.4.2. currency string Да Валюта
Должно быть равно KZT
4.5. vat boolean Нет Отметка включения НДС
4.6. urgent boolean Нет Отметка срочности платежа
При указании значения true комиссия за проведение срочного платежа будет списана согласно вашему тарифному плану
4.7. payerIban string Да Номер счета плательщика
Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
4.8. documentId string Да Номер документа плательщика
Может содержать буквы и цифры. При заполнении цифрами — не должен превышать 19 символов. При заполнении цифрами и буквами — не должен превышать 200 символов.
4.9. permitRecord boolean Да Разрешительная запись, сопровождающая платеж от резидента Республики Казахстан в адрес нерезидента. Параметр не предоставляет разрешения на исполнение операции, а используется исключительно для фиксации факта операции в Национальном Банке Республики Казахстан (НБ РК)
4.10. paymentPurpose string Да Назначение платежа
Может принимать буквы и цифры. Не должен превышать 482 символов

Сформированный payload платежа подписать ЭЦП. Подробнее вы можете ознакомиться в Инструкции по использованию NCALayer.
Затем сформировать запрос к методу — Выполнить платеж контрагенту в банк в Казахстане

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
content
required
string <JWS, base64url-encoded>

Сведения о платеже, подписанные ЭЦП

Responses

Request samples

Content type
application/json
{
  • "content": "eyJzcGFuaWQiOiI1MGM2MzY1ODRmNGM0NzZiYjkxMjFhOWMwOTMzYjBmMjU4ODExYjgzOWJlZDM4ZTJmMDMwYmVjYWM3ZWQ2N2FhIiwiY3R5IjoiYXBwbGljYXRpb24vanNvbiIsInR5cCI6IkpPU0UiLCJhbGciOiJFQ0dPU1QzNDEwLTIwMTUtNTEyIiwidHMiOiIxNzU5NTAxMTkzMDQ4IiwieDVjIjpbIk1JSUV2RENDQkNTZ0F3SUJBZ0lRV0t3cEFyLy93OCs5OE9TcThucnQ1ekFPQmdvcWd3NERDZ0VCQWdNQ0JRQXdSekVqTUNFR0ExVUVBd3dhVFhrZ1EyOXRjR0Z1ZVNCSmJuUmxjbTFsWkdsaGRHVWdRMEV4RXpBUkJnTlZCQW9NQ2sxNUlFTnZiWEJoYm5reEN6QUpCZ05WQkFZVEFrdGFNQjRYRFRJMU1Ea3dNakE1TURVek5Wb1hEVEkyTURrd01qQTVNRFV6TlZvd2dmWXhSekJGQmdOVkJBTU1QdENVMExqUmdOQzEwTHJSZ3RDKzBZRFF2dEN5SU5DVTBMalJnTkMxMExyUmd0QyswWUFnMEpUUXVOR0EwTFhRdXRHQzBMN1JnTkMrMExMUXVOR0hNUjB3R3dZRFZRUUVEQlRRbE5DNDBZRFF0ZEM2MFlMUXZ0R0EwTDdRc2pFWU1CWUdBMVVFQlJNUFNVbE9PRGd4TWpJeU1EVXdOVFEwTVFzd0NRWURWUVFHRXdKTFdqRW9NQ1lHQTFVRUNnd2YwS0xRbnRDZUlOQ2cwTDdRczlDd0lOQzRJTkNhMEw3UXY5R0wwWUxRc0RFWU1CWUdBMVVFQ3d3UFFrbE9NVE13TlRRd01ERTRPREU1TVNFd0h3WURWUVFxREJqUWxOQzQwWURRdGRDNjBZTFF2dEdBMEw3UXN0QzQwWWN3Z2F3d0l3WUpLb01PQXdvQkFRSUNNQllHQ2lxRERnTUtBUUVDQWdFR0NDcUREZ01LQVFNREE0R0VBQVNCZ04wVjFydHI4bHcySXRJTFFTUGlyRXFyc2k2OHBJM2xjR0NJMFFaN3hRbXNqQkM1MWpuVXF6N2tlcVR2SGNMbCtXbXJiM0Ntdmd6aVdicmU1a3VPMThEMUlWd3FGdVdqaVFQNytpVG9GLzZOVms1azM1OFY3REs0ckdrbTdmMnVPNm1oT2oyeUlIM1hXbzY3aWt2MEFQS0FGWVRBZWJTT050ZGU4aGJuTDhwU280SUI2RENDQWVRd0h3WURWUjBqQkJnd0ZvQVVzU1p3YXdyUTZETENrdzRjVWN3SDk0Z3RENGt3SFFZRFZSME9CQllFRkl2d3duYlY4TG5BODlrMm85bjU5dXRLVE1HS01BNEdBMVVkRHdFQi93UUVBd0lHd0RBb0JnTlZIU1VFSVRBZkJnZ3JCZ0VGQlFjREJBWUlLb01PQXdNRUFRSUdDU3FERGdNREJBRUNBakE0QmdOVkhTQUVNVEF2TUMwR0JpcUREZ01EQWpBak1DRUdDQ3NHQVFVRkJ3SUJGaFZvZEhSd09pOHZjR3RwTG1kdmRpNXJlaTlqY0hNd2RRWUlLd1lCQlFVSEFRRUVhVEJuTUNnR0NDc0dBUVVGQnpBQmhoeG9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDI5amMzQXZNRHNHQ0NzR0FRVUZCekFDaGk5b2RIUndPaTh2ZEdWemRDNXdhMmt1WjI5MkxtdDZMMk5sY25RdmFXNTBaWEp0WldScFlYUmxYMk5oTG1ObGNqQS9CZ05WSFI4RU9EQTJNRFNnTXFBd2hpNW9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDJOeWJDOXBiblJsY20xbFpHbGhkR1ZmWTJFdVkzSnNNRUVHQTFVZExnUTZNRGd3TnFBMG9ES0dNR2gwZEhBNkx5OTBaWE4wTG5CcmFTNW5iM1l1YTNvdlkzSnNMMmx1ZEdWeWJXVmthV0YwWlY5allWOWtMbU55YkRBYkJnTlZIUkVFRkRBU2dSQjFjMlZ5UUdWNFlXMXdiR1V1WTI5dE1CWUdCaXFERGdNREJRUU1NQW9HQ0NxRERnTURBd0VCTUE0R0NpcUREZ01LQVFFQ0F3SUZBQU9CZ1FBbVdqUCtPaERMb0VYMiszeDQzYlVEakJuVFpTN0VDNEJjczNRVW5Oc28wMXNBTTYwc2xrMXBRblJaL091ZG9TeEVpTzNZSmt0UEFncnJiSG04YjlwWXZQSjNsNUh2QjhQUTF0NkszditzV0kzdDBZa1g5aVhHa2VIOTdlT2dheUZhOFRvOUVVZThQeHlNcTk0MGJIY0srQi9TQXUydG9DUDFVTVZVMEM4SEdRPT0iXX0.eyJ0eXBlIjoiSU5URVJOQUwiLCJjYXRlZ29yeSI6IkRPTUVTVElDIiwicGF5bWVudFJlY2lwaWVudCI6eyJyZWNpcGllbnRBY2NvdW50Ijp7ImliYW4iOiJLWjE4OTk4NVRCMDAwMTQ4NTgyMCIsImJpYyI6IlRTRVNLWktBIn0sImlpbk9yQmluIjoic3RyaW5nIiwiY291bnRyeUNvZGUiOm51bGwsImZhY3R1YWxSZWNpcGllbnQiOnsiaWluT3JCaW4iOiJzdHJpbmciLCJuYW1lIjoic3RyaW5nIn0sImtiZSI6eyJjb2RlIjoiMTciLCJuYW1lIjoiICAgIn19LCJkZXRhaWxzIjp7ImtucCI6eyJjb2RlIjoiODU1IiwibmFtZSI6ItCb0LjQt9C40L3QsyAo0YLQtdC60YPRidCw0Y8g0LDRgNC10L3QtNCwKSJ9LCJkZXNjcmlwdGlvbiI6ItC-0L_Qu9Cw0YLQsCDQt9CwINCw0YDQtdC90LTRgyDRgdC_0LXRhtGC0LXRhdC90LjQutC4INC_0L4g0YHRh9C10YLRgyDQvdCwINC-0L_Qu9Cw0YLRgyAwNiDQvtGCIDIwLjA4LjIwMjXQsyDQn9C70LDRgtC10LbQuCDQv9C-INC70LjQt9C40L3Qs9GDICjRgtC10LrRg9GJ0LDRjyDQsNGA0LXQvdC00LApLi4g0JvQuNC30LjQvdCzICjRgtC10LrRg9GJ0LDRjyDQsNGA0LXQvdC00LApIiwicGF5bWVudEFtb3VudCI6eyJhbW91bnQiOjE4MDAuMDAsImN1cnJlbmN5IjoiS1pUIn0sInZhdCI6ZmFsc2UsInVyZ2VudCI6ZmFsc2UsInBheWVySWJhbiI6IktaOTQ5OTg1VEIwMDAxNDg1ODEwIiwiZG9jdW1lbnRJZCI6IjIiLCJwZXJtaXRSZWNvcmQiOm51bGwsInBheW1lbnRQdXJwb3NlIjoi0L7Qv9C70LDRgtCwINC30LAg0LDRgNC10L3QtNGDINGB0L_QtdGG0YLQtdGF0L3QuNC60Lgg0L_QviDRgdGH0LXRgtGDINC90LAg0L7Qv9C70LDRgtGDIDA2INC-0YIgMjAuMDguMjAyNdCzINCf0LvQsNGC0LXQttC4INC_0L4g0LvQuNC30LjQvdCz0YMgKNGC0LXQutGD0YnQsNGPINCw0YDQtdC90LTQsCkuIn19.7kjQvcgO9dSX5Xp4HjbQ42afCl7xqO4w-ZsMviLP4hTPmgJk8Jdctsr4fjkzaN51pLJjAuVFOEUDlpYsxTcxHrEMJdxjKiMhJIkUGcE8ZDN86kZgRwURdBzl4er2aL0CuyzqDfnl3EG0TGoe6uinXWEgWK_mks6lEm7OEhkAfOI"
}

Response samples

Content type
application/json
{
  • "type": "string",
  • "category": "string",
  • "payment": {
    }
}

Зарплатный платеж

Для создания платежа сформировать payload платежа по нижеприведенной структуре:

{
  "category": "DOMESTIC",
  "type": "SALARY",
  "paymentRecipient": {
    "iinOrBin": "920140000084",
    "recipientAccount": {
      "iban": "KZ34998ARB0000075966",
      "bic": "TSESKZKA"
    }
  },
  "details": {
    "knp": {
      "code": "332",
      "name": "Перечисление юридическим лицом в банк заработной платы, оплаты трудового отпуска для последующего зачисления на банковские счета работников данного юридического лица"
    },
    "description": "test. Перечисление юридическим лицом в банк заработной платы, оплаты трудового отпуска для последующего зачисления на банковские счета работников данного юридического лица",
    "paymentAmount": {
      "amount": 20000.00,
      "currency": "KZT"
    },
    "payerIban": "KZ11111AAA1111111111",
    "urgent": false,
    "documentId": "184",
    "factualSender": null
  },
  "paymentEmployees": [
    {
      "iban": "KZ99998ARB0000011111",
      "iin": "71111111111",
      "lastName": "ТЕСТ",
      "firstName": "ТЕСТ",
      "middleName": "ТЕСТОВИЧ",
      "paymentAmount": {
        "amount": 20000.00,
        "currency": "KZT"
      },
      "kbe": {
        "code": "29"
      },
      "countryCode": "AD"
    }
  ]
}
№ Параметр Тип данных Обязательность Описание
1 type string Да Тип платежа.

Значение: SALARY – Зарплатный платеж
2 category string Да Категория платежа.

Значение: DOMESTIC – Платежи в тенге
3 paymentRecipient object Да Информация о получателе
3.1 iinOrBin string Да БИН получателя.

Может принимать только 12 цифровых символов
3.2 recipientAccount object Да Счет получателя
3.2.1 iban string Да Номер счета получателя.

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
3.2.2 bic string Да БИК банка получателя.

Должен принимать соответствующий БИК банка. Содержит только 8 заглавных букв и цифр
4 details object Да Детальная информация
4.1 knp object Да КНП.

Для корректности заполнения по данному параметру используйте методы из справочника
4.1.1 code string Да Код КНП.

Содержит только 3 цифры
4.1.2 name string Нет Название кода КНП.

Может содержать буквы и цифры. Не должен превышать 200 символов
4.2 description string Да Назначение платежа.

Не должен превышать 480 символов
4.3 paymentAmount object Да Сумма платежа
4.3.1 amount number Да Сумма.

Сумма больше 0, не больше 1 000 000 000 000. Не превышает 2-х знаков после запятой
4.3.2 currency string Да Валюта.

Должно быть равно KZT
4.4 payerIban string Да Номер счета плательщика.

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
4.5 urgent boolean Да Отметка срочности платежа.

Значение true может быть указано только при отправке платежа до 16.00 (GMT+5).
При указании true комиссия за проведение срочного платежа будет списана согласно Вашему тарифному плану.
При отправке после 16.00 платеж не может быть проведен как срочный.
4.6 documentId string Да Номер документа плательщика.

Может содержать буквы и цифры и не должен превышать 50 символов
4.7 factualSender object Да Фактический отправитель.

При уплате платежей в бюджет за свое обособленное подразделение укажите в параметре factualSender наименование этого подразделения, а также его БИН
4.7.1 iinOrBin string Да БИН своего обособленного подразделения - фактического отправителя.

Может принимать только 12 цифровых символов. Для нерезидентов допускается значение 000000000000
4.7.2 name string Да Название своего обособленного подразделения - фактического отправителя.

Может содержать только буквы и цифры. Не должен превышать 250 символов
5 paymentEmployees arrayOfObjects Да Список сотрудников к платежу
5.1 iban string Да Номер счета сотрудника.

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
5.2 iin string Да ИИН.

Может принимать только 12 цифровых символов
5.3 lastName string Нет Фамилия сотрудника
5.4 firstName string Да Имя сотрудника
5.5 middleName string Нет Отчество сотрудника
5.6 paymentAmount object Да Сумма платежа
5.6.1 amount number Да Сумма.

Сумма больше 0, меньше 1 000 000 000 000. Не превышает 2-х знаков после запятой
5.6.2 currency string Да Валюта.

Должно быть равно KZT
5.7 kbe object Да КБЕ.

Для корректности заполнения по данному параметру используйте методы из справочника
5.7.1 code string Да Код КБЕ.
5.8 countryCode string Нет Страна резидентства.

Обязательно для заполнения, если сотрудник - нерезидент РК

Сформированный payload платежа подписать ЭЦП. Подробнее вы можете ознакомиться в Инструкции по использованию NCALayer.
Затем сформировать запрос к методу — Выполнить зарплатный платеж.

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
content
required
string <JWS, base64url-encoded>

Сведения о платеже, подписанные ЭЦП

Responses

Request samples

Content type
application/json
{
  • "content": "eyJzcGFuaWQiOiI2ZjE1YzM4NTUxMmY0YWRjNzFmOTkzMmZmMzdlYzg1MGU5MmFiNjY4ZDMwNzQ4MzQwZGUwYTQ0MDc3MDk4ZTVkIiwiY3R5IjoiYXBwbGljYXRpb24vanNvbiIsInR5cCI6IkpPU0UiLCJhbGciOiJFQ0dPU1QzNDEwLTIwMTUtNTEyIiwidHMiOiIxNzY0Njg5NjUyOTY1IiwieDVjIjpbIk1JSUV2RENDQkNTZ0F3SUJBZ0lRV0t3cEFyLy93OCs5OE9TcThucnQ1ekFPQmdvcWd3NERDZ0VCQWdNQ0JRQXdSekVqTUNFR0ExVUVBd3dhVFhrZ1EyOXRjR0Z1ZVNCSmJuUmxjbTFsWkdsaGRHVWdRMEV4RXpBUkJnTlZCQW9NQ2sxNUlFTnZiWEJoYm5reEN6QUpCZ05WQkFZVEFrdGFNQjRYRFRJMU1Ea3dNakE1TURVek5Wb1hEVEkyTURrd01qQTVNRFV6TlZvd2dmWXhSekJGQmdOVkJBTU1QdENVMExqUmdOQzEwTHJSZ3RDKzBZRFF2dEN5SU5DVTBMalJnTkMxMExyUmd0QyswWUFnMEpUUXVOR0EwTFhRdXRHQzBMN1JnTkMrMExMUXVOR0hNUjB3R3dZRFZRUUVEQlRRbE5DNDBZRFF0ZEM2MFlMUXZ0R0EwTDdRc2pFWU1CWUdBMVVFQlJNUFNVbE9PRGd4TWpJeU1EVXdOVFEwTVFzd0NRWURWUVFHRXdKTFdqRW9NQ1lHQTFVRUNnd2YwS0xRbnRDZUlOQ2cwTDdRczlDd0lOQzRJTkNhMEw3UXY5R0wwWUxRc0RFWU1CWUdBMVVFQ3d3UFFrbE9NVE13TlRRd01ERTRPREU1TVNFd0h3WURWUVFxREJqUWxOQzQwWURRdGRDNjBZTFF2dEdBMEw3UXN0QzQwWWN3Z2F3d0l3WUpLb01PQXdvQkFRSUNNQllHQ2lxRERnTUtBUUVDQWdFR0NDcUREZ01LQVFNREE0R0VBQVNCZ04wVjFydHI4bHcySXRJTFFTUGlyRXFyc2k2OHBJM2xjR0NJMFFaN3hRbXNqQkM1MWpuVXF6N2tlcVR2SGNMbCtXbXJiM0Ntdmd6aVdicmU1a3VPMThEMUlWd3FGdVdqaVFQNytpVG9GLzZOVms1azM1OFY3REs0ckdrbTdmMnVPNm1oT2oyeUlIM1hXbzY3aWt2MEFQS0FGWVRBZWJTT050ZGU4aGJuTDhwU280SUI2RENDQWVRd0h3WURWUjBqQkJnd0ZvQVVzU1p3YXdyUTZETENrdzRjVWN3SDk0Z3RENGt3SFFZRFZSME9CQllFRkl2d3duYlY4TG5BODlrMm85bjU5dXRLVE1HS01BNEdBMVVkRHdFQi93UUVBd0lHd0RBb0JnTlZIU1VFSVRBZkJnZ3JCZ0VGQlFjREJBWUlLb01PQXdNRUFRSUdDU3FERGdNREJBRUNBakE0QmdOVkhTQUVNVEF2TUMwR0JpcUREZ01EQWpBak1DRUdDQ3NHQVFVRkJ3SUJGaFZvZEhSd09pOHZjR3RwTG1kdmRpNXJlaTlqY0hNd2RRWUlLd1lCQlFVSEFRRUVhVEJuTUNnR0NDc0dBUVVGQnpBQmhoeG9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDI5amMzQXZNRHNHQ0NzR0FRVUZCekFDaGk5b2RIUndPaTh2ZEdWemRDNXdhMmt1WjI5MkxtdDZMMk5sY25RdmFXNTBaWEp0WldScFlYUmxYMk5oTG1ObGNqQS9CZ05WSFI4RU9EQTJNRFNnTXFBd2hpNW9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDJOeWJDOXBiblJsY20xbFpHbGhkR1ZmWTJFdVkzSnNNRUVHQTFVZExnUTZNRGd3TnFBMG9ES0dNR2gwZEhBNkx5OTBaWE4wTG5CcmFTNW5iM1l1YTNvdlkzSnNMMmx1ZEdWeWJXVmthV0YwWlY5allWOWtMbU55YkRBYkJnTlZIUkVFRkRBU2dSQjFjMlZ5UUdWNFlXMXdiR1V1WTI5dE1CWUdCaXFERGdNREJRUU1NQW9HQ0NxRERnTURBd0VCTUE0R0NpcUREZ01LQVFFQ0F3SUZBQU9CZ1FBbVdqUCtPaERMb0VYMiszeDQzYlVEakJuVFpTN0VDNEJjczNRVW5Oc28wMXNBTTYwc2xrMXBRblJaL091ZG9TeEVpTzNZSmt0UEFncnJiSG04YjlwWXZQSjNsNUh2QjhQUTF0NkszditzV0kzdDBZa1g5aVhHa2VIOTdlT2dheUZhOFRvOUVVZThQeHlNcTk0MGJIY0srQi9TQXUydG9DUDFVTVZVMEM4SEdRPT0iXX0.eyJjYXRlZ29yeSI6ICJET01FU1RJQyIsICJ0eXBlIjogIlNBTEFSWSIsICJwYXltZW50UmVjaXBpZW50IjogeyJpaW5PckJpbiI6ICI5MjAxNDAwMDAwODQiLCAicmVjaXBpZW50QWNjb3VudCI6IHsiaWJhbiI6ICJLWjM0OTk4QVJCMDAwMDA3NTk2NiIsICJiaWMiOiAiVFNFU0taS0EifX0sICJkZXRhaWxzIjogeyJrbnAiOiB7ImNvZGUiOiAiMzMyIiwgIm5hbWUiOiAi0J_QtdGA0LXRh9C40YHQu9C10L3QuNC1INGO0YDQuNC00LjRh9C10YHQutC40Lwg0LvQuNGG0L7QvCDQsiDQsdCw0L3QuiDQt9Cw0YDQsNCx0L7RgtC90L7QuSDQv9C70LDRgtGLLCDQvtC_0LvQsNGC0Ysg0YLRgNGD0LTQvtCy0L7Qs9C-INC-0YLQv9GD0YHQutCwINC00LvRjyDQv9C-0YHQu9C10LTRg9GO0YnQtdCz0L4g0LfQsNGH0LjRgdC70LXQvdC40Y8g0L3QsCDQsdCw0L3QutC-0LLRgdC60LjQtSDRgdGH0LXRgtCwINGA0LDQsdC-0YLQvdC40LrQvtCyINC00LDQvdC90L7Qs9C-INGO0YDQuNC00LjRh9C10YHQutC-0LPQviDQu9C40YbQsCJ9LCAiZGVzY3JpcHRpb24iOiAidGVzdC4g0J_QtdGA0LXRh9C40YHQu9C10L3QuNC1INGO0YDQuNC00LjRh9C10YHQutC40Lwg0LvQuNGG0L7QvCDQsiDQsdCw0L3QuiDQt9Cw0YDQsNCx0L7RgtC90L7QuSDQv9C70LDRgtGLLCDQvtC_0LvQsNGC0Ysg0YLRgNGD0LTQvtCy0L7Qs9C-INC-0YLQv9GD0YHQutCwINC00LvRjyDQv9C-0YHQu9C10LTRg9GO0YnQtdCz0L4g0LfQsNGH0LjRgdC70LXQvdC40Y8g0L3QsCDQsdCw0L3QutC-0LLRgdC60LjQtSDRgdGH0LXRgtCwINGA0LDQsdC-0YLQvdC40LrQvtCyINC00LDQvdC90L7Qs9C-INGO0YDQuNC00LjRh9C10YHQutC-0LPQviDQu9C40YbQsCIsICJwYXltZW50QW1vdW50IjogeyJhbW91bnQiOiAyMDAwMC4wLCAiY3VycmVuY3kiOiAiS1pUIn0sICJwYXllckliYW4iOiAiS1oxMTExMUFBQTExMTExMTExMTEiLCAidXJnZW50IjogZmFsc2UsICJkb2N1bWVudElkIjogIjE4NCIsICJmYWN0dWFsU2VuZGVyIjogbnVsbH0sICJwYXltZW50RW1wbG95ZWVzIjogW3siaWJhbiI6ICJLWjk5OTk4QVJCMDAwMDAxMTExMSIsICJpaW4iOiAiNzExMTExMTExMTEiLCAibGFzdE5hbWUiOiAi0KLQldCh0KIiLCAiZmlyc3ROYW1lIjogItCi0JXQodCiIiwgIm1pZGRsZU5hbWUiOiAi0KLQldCh0KLQntCS0JjQpyIsICJwYXltZW50QW1vdW50IjogeyJhbW91bnQiOiAyMDAwMC4wLCAiY3VycmVuY3kiOiAiS1pUIn0sICJrYmUiOiB7ImNvZGUiOiAiMjkifSwgImNvdW50cnlDb2RlIjogIkFEIn1dfQ.wk9QS0sdpN-aiuvTRWaqV5uK7FkinJNJ-UNcoiVQMhurxvZzdZLckJK02lfObYRqp_T56w9hLXSTHUvyCG0GoB4Jh3W-VtEbxkihUOeAspNq-loTv02nlmuI5c-r0TighRoB2DoYtjxts_CjAPHukgp-VPZ11lO3tEDFYY-sNzw"
}

Response samples

Content type
application/json
{
  • "type": "SALARY",
  • "category": "DOMESTIC",
  • "payment": {
    }
}

Налоговый платеж

Для создания платежа сформировать payload платежа по нижеприведенной структуре:

{
  "type": "TAX",
  "category": "DOMESTIC",
  "paymentRecipient": {
    "iinOrBin": "141040004756",
    "name": "РГУ \"Комитет государственных доходов Министерства финансов\"",
    "recipientAccount": {
      "iban": "KZ24070105KSN0000000",
      "bankName": "РГУ \"Комитет казначейства Министерства финансов РК\"",
      "bic": "KKMFKZ2A"
    },
    "kbе": {
      "code": "11",
      "name": null
    }
  },
  "details": {
    "knp": {
      "code": "390",
      "name": "Прочие платежи по разделу 3"
    },
    "kbk": {
      "code": "101201",
      "name": "Индивидуальный подоходный налог с доходов, облагаемых у источника выплаты"
    },
    "description": "Индивидуальный подоходный налог с доходов, облагаемых у источника выплаты Прочие платежи",
    "tax": {
      "periodStart": "2025-01",
      "periodEnd": "2025-03"
    },
    "paymentAmount": {
      "amount": 20000.00,
      "currency": "KZT"
    },
    "urgent": false,
    "payerIban": "KZ99999HTB0000111111",
    "documentId": "170",
    "factualSender": null
  }
}
№ Параметр Тип данных Обязательность Описание
1 type string Да Тип платежа.

Значение: TAX – Налоговый платеж
2 category string Да Категория платежа.

Может принимать только значение DOMESTIC – Платежи в тенге
3 paymentRecipient object Да Информация о получателе
3.1 iinOrBin string(12) Да БИН или ИИН получателя
Может принимать только 12 цифровых символов
3.2 name string Да Название организации получателя

Должен принимать соответствующее название бюджетной организации. Не должен превышать 200 символов.
3.3 recipientAccount object Да Счет получателя
3.3.1 iban string Да Номер счета получателя

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
3.3.2 bankName string Да Название бюджетной организации
3.3.3 bic string Да БИК банка получателя
Содержит только 8 заглавных букв и цифр.
3.4 kbe object Да КБЕ
Для корректности заполнения по данному параметру используйте методы из справочника.
3.4.1 code string Да Код КБЕ
Для налоговых платежей код равен 11
3.4.2 name string Нет Наименование КБЕ
4 details object Да Детальная информация
4.1 knp object Да КНП
Для корректности заполнения по данному параметру используйте методы из справочника
4.1.1 code string Да Код КНП
Содержит только 3 цифры
4.1.2 name string Нет Название кода КБК
Может содержать буквы и цифры. Не должен превышать 200 символов
4.2 kbk object Да КБК
Для корректности заполнения по данному параметру используйте методы из справочника
4.2.1 code string Да Код КБК
Содержит только 6 цифр
4.2.2 name string Да Название кода КБК
Может содержать буквы и цифры. Не должен превышать 200 символов
4.3 description string Да Назначение платежа
Может принимать буквы и цифры. Не должен превышать 480 символов
4.4 tax object Да Платежный период
4.4.1 periodStart string<YYYY-MM> Да Начало периода, за который происходит налоговый платеж.
4.4.2 periodEnd string<YYYY-MM> Да Конец периода, за который происходит налоговый платеж.
4.4.3 vin string УО VIN (Идентификационный номер транспортного средства)
Может содержать цифры и буквы и не должен превышать 17 символов.
Если код КБК указан 104401 или 104402, то поле является обязательным.
4.4.4 protocolNumber string УО Номер протокола
Если код КБК указан 204***, то обязательно указывать номер протокола
Формат: ADM***/A
Пример, ADM00889911/A
4.5 payerIban string Да Номер счета плательщика
Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
4.6 paymentAmount object Да Сумма платежа
4.6.1 amount number Да Сумма
Сумма больше 0, не больше 1 000 000 000 000. Не превышает 2-ух знаков после запятой
4.6.2 currency string Да Валюта
Должно быть равно KZT
4.7 urgent boolean Да Отметка срочности платежа
Значение true может быть указана только при отправке платежа до 16.00 в соответствии с часовым поясом Алматы (GMT+5).
При указании значения true комиссия за проведение срочного платежа будет списана согласно Вашему тарифному плану.
При отправке платежа после 16.00 в соответствии с часовым поясом Алматы (GMT+5), платеж не может быть проведен как срочный.
4.8 documentId string Да Номер документа плательщика
Может содержать буквы и цифры, не должен превышать 50 символов
4.9 factualSender object Да Фактический отправитель
При уплате платежей в бюджет за свое обособленное подразделение укажите в параметре factualSender наименование этого подразделения, а также его БИН
4.9.1 iinOrBin string Да БИН своего обособленного подразделения - фактического отправителя
Может принимать только 12 цифровых символов.
Для нерезидентов допускается значение 000000000000
4.9.2 name string Да Название своего обособленного подразделения - фактического отправителяМожет содержать только буквы и цифры. Не должен превышать 250 символов.

Сформированный payload платежа подписать ЭЦП. Подробнее вы можете ознакомиться в Инструкции по использованию NCALayer.
Затем сформировать запрос к методу — Выполнить налоговый платеж.

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
content
required
string <JWS, base64url-encoded>

Сведения о платеже, подписанные ЭЦП

Responses

Request samples

Content type
application/json
{
  • "content": "eyJzcGFuaWQiOiJmMjVkZjIwYzM4ZmNhMGRiNjgwNmNlZjZhOTI4MjQ3ODFjODQzODMzYTc3Zjc5NTZlM2M2MTkyMmJiMTM5OGI5IiwiY3R5IjoiYXBwbGljYXRpb24vanNvbiIsInR5cCI6IkpPU0UiLCJhbGciOiJFQ0dPU1QzNDEwLTIwMTUtNTEyIiwidHMiOiIxNzU5ODU0NDcwMjk5IiwieDVjIjpbIk1JSUV2RENDQkNTZ0F3SUJBZ0lRV0t3cEFyLy93OCs5OE9TcThucnQ1ekFPQmdvcWd3NERDZ0VCQWdNQ0JRQXdSekVqTUNFR0ExVUVBd3dhVFhrZ1EyOXRjR0Z1ZVNCSmJuUmxjbTFsWkdsaGRHVWdRMEV4RXpBUkJnTlZCQW9NQ2sxNUlFTnZiWEJoYm5reEN6QUpCZ05WQkFZVEFrdGFNQjRYRFRJMU1Ea3dNakE1TURVek5Wb1hEVEkyTURrd01qQTVNRFV6TlZvd2dmWXhSekJGQmdOVkJBTU1QdENVMExqUmdOQzEwTHJSZ3RDKzBZRFF2dEN5SU5DVTBMalJnTkMxMExyUmd0QyswWUFnMEpUUXVOR0EwTFhRdXRHQzBMN1JnTkMrMExMUXVOR0hNUjB3R3dZRFZRUUVEQlRRbE5DNDBZRFF0ZEM2MFlMUXZ0R0EwTDdRc2pFWU1CWUdBMVVFQlJNUFNVbE9PRGd4TWpJeU1EVXdOVFEwTVFzd0NRWURWUVFHRXdKTFdqRW9NQ1lHQTFVRUNnd2YwS0xRbnRDZUlOQ2cwTDdRczlDd0lOQzRJTkNhMEw3UXY5R0wwWUxRc0RFWU1CWUdBMVVFQ3d3UFFrbE9NVE13TlRRd01ERTRPREU1TVNFd0h3WURWUVFxREJqUWxOQzQwWURRdGRDNjBZTFF2dEdBMEw3UXN0QzQwWWN3Z2F3d0l3WUpLb01PQXdvQkFRSUNNQllHQ2lxRERnTUtBUUVDQWdFR0NDcUREZ01LQVFNREE0R0VBQVNCZ04wVjFydHI4bHcySXRJTFFTUGlyRXFyc2k2OHBJM2xjR0NJMFFaN3hRbXNqQkM1MWpuVXF6N2tlcVR2SGNMbCtXbXJiM0Ntdmd6aVdicmU1a3VPMThEMUlWd3FGdVdqaVFQNytpVG9GLzZOVms1azM1OFY3REs0ckdrbTdmMnVPNm1oT2oyeUlIM1hXbzY3aWt2MEFQS0FGWVRBZWJTT050ZGU4aGJuTDhwU280SUI2RENDQWVRd0h3WURWUjBqQkJnd0ZvQVVzU1p3YXdyUTZETENrdzRjVWN3SDk0Z3RENGt3SFFZRFZSME9CQllFRkl2d3duYlY4TG5BODlrMm85bjU5dXRLVE1HS01BNEdBMVVkRHdFQi93UUVBd0lHd0RBb0JnTlZIU1VFSVRBZkJnZ3JCZ0VGQlFjREJBWUlLb01PQXdNRUFRSUdDU3FERGdNREJBRUNBakE0QmdOVkhTQUVNVEF2TUMwR0JpcUREZ01EQWpBak1DRUdDQ3NHQVFVRkJ3SUJGaFZvZEhSd09pOHZjR3RwTG1kdmRpNXJlaTlqY0hNd2RRWUlLd1lCQlFVSEFRRUVhVEJuTUNnR0NDc0dBUVVGQnpBQmhoeG9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDI5amMzQXZNRHNHQ0NzR0FRVUZCekFDaGk5b2RIUndPaTh2ZEdWemRDNXdhMmt1WjI5MkxtdDZMMk5sY25RdmFXNTBaWEp0WldScFlYUmxYMk5oTG1ObGNqQS9CZ05WSFI4RU9EQTJNRFNnTXFBd2hpNW9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDJOeWJDOXBiblJsY20xbFpHbGhkR1ZmWTJFdVkzSnNNRUVHQTFVZExnUTZNRGd3TnFBMG9ES0dNR2gwZEhBNkx5OTBaWE4wTG5CcmFTNW5iM1l1YTNvdlkzSnNMMmx1ZEdWeWJXVmthV0YwWlY5allWOWtMbU55YkRBYkJnTlZIUkVFRkRBU2dSQjFjMlZ5UUdWNFlXMXdiR1V1WTI5dE1CWUdCaXFERGdNREJRUU1NQW9HQ0NxRERnTURBd0VCTUE0R0NpcUREZ01LQVFFQ0F3SUZBQU9CZ1FBbVdqUCtPaERMb0VYMiszeDQzYlVEakJuVFpTN0VDNEJjczNRVW5Oc28wMXNBTTYwc2xrMXBRblJaL091ZG9TeEVpTzNZSmt0UEFncnJiSG04YjlwWXZQSjNsNUh2QjhQUTF0NkszditzV0kzdDBZa1g5aVhHa2VIOTdlT2dheUZhOFRvOUVVZThQeHlNcTk0MGJIY0srQi9TQXUydG9DUDFVTVZVMEM4SEdRPT0iXX0.eyJ0eXBlIjoiVEFYIiwiY2F0ZWdvcnkiOiJET01FU1RJQyIsInBheW1lbnRSZWNpcGllbnQiOnsiaWluT3JCaW4iOiIxNDEwNDAwMDQ3NTYiLCJuYW1lIjoi0KDQk9CjIFwi0JrQvtC80LjRgtC10YIg0LPQvtGB0YPQtNCw0YDRgdGC0LLQtdC90L3Ri9GFINC00L7RhdC-0LTQvtCyINCc0LjQvdC40YHRgtC10YDRgdGC0LLQsCDRhNC40L3QsNC90YHQvtCyXCIiLCJyZWNpcGllbnRBY2NvdW50Ijp7ImliYW4iOiJLWjI0MDcwMTA1S1NOMDAwMDAwMCIsImJhbmtOYW1lIjoi0KDQk9CjIFwi0JrQvtC80LjRgtC10YIg0LrQsNC30L3QsNGH0LXQudGB0YLQstCwINCc0LjQvdC40YHRgtC10YDRgdGC0LLQsCDRhNC40L3QsNC90YHQvtCyINCg0JpcIiIsImJpYyI6IktLTUZLWjJBIn0sImti0LUiOnsiY29kZSI6IjE3IiwibmFtZSI6bnVsbH19LCJkZXRhaWxzIjp7ImtucCI6eyJjb2RlIjoiMzkwIiwibmFtZSI6ItCf0YDQvtGH0LjQtSDQv9C70LDRgtC10LbQuCDQv9C-INGA0LDQt9C00LXQu9GDIDMifSwia2JrIjp7ImNvZGUiOiIxMDEyMDEiLCJuYW1lIjoi0JjQvdC00LjQstC40LTRg9Cw0LvRjNC90YvQuSDQv9C-0LTQvtGF0L7QtNC90YvQuSDQvdCw0LvQvtCzINGBINC00L7RhdC-0LTQvtCyLCDQvtCx0LvQsNCz0LDQtdC80YvRhSDRgyDQuNGB0YLQvtGH0L3QuNC60LAg0LLRi9C_0LvQsNGC0YsifSwiZGVzY3JpcHRpb24iOiLQmNC90LTQuNCy0LjQtNGD0LDQu9GM0L3Ri9C5INC_0L7QtNC-0YXQvtC00L3Ri9C5INC90LDQu9C-0LMg0YEg0LTQvtGF0L7QtNC-0LIsINC-0LHQu9Cw0LPQsNC10LzRi9GFINGDINC40YHRgtC-0YfQvdC40LrQsCDQstGL0L_Qu9Cw0YLRiyDQn9GA0L7Rh9C40LUg0L_Qu9Cw0YLQtdC20LgiLCJwZXJpb2QiOiIyMDI1LTA5IiwicGF5bWVudEFtb3VudCI6eyJhbW91bnQiOjIwMDAwLjAwLCJjdXJyZW5jeSI6IktaVCJ9LCJ1cmdlbnQiOmZhbHNlLCJwYXllckliYW4iOiJLWjk5OTk5SFRCMDAwMDExMTExMSIsImRvY3VtZW50SWQiOiIxNzAiLCJmYWN0dWFsU2VuZGVyIjpudWxsfX0.2l-OLodHWa4LSoZ2LwNZkWZjRwBaJt-M-inlrWP726FgXZNKKqEoyalFpytmODm5OcxpbVvwS0HPuLFqZT-UVGik666m3r1bG8kM-Tyb6Hc0bZJwhMsO8kTTtVKl1_UG6uGeKtoveM3urvCEcWX7aei7vQB0iCvUyxElWKVp_o4"
}

Response samples

Content type
application/json
Example
{
  • "type": "TAX",
  • "category": "DOMESTIC",
  • "payment": {
    }
}

Платеж в бюджет

Для создания платежа сформировать payload платежа по нижеприведенной структуре:

{
  "category": "DOMESTIC",
  "type": "SOCIAL",
  "paymentRecipient": {
    "iinOrBin": "160440007161",
    "name": "НАО \"Государственная корпорация «Правительство для граждан\"",
    "kbe": {
      "code": "11"
    },
    "recipientAccount": {
      "iban": "KZ12009NPS0413609816",
      "bankName": "НАО \"Государственная корпорация «Правительство для граждан\"",
      "bic": "GCVPKZ2A"
    }
  },
  "details": {
    "knp": {
      "code": "012",
      "name": "Обязательные социальные отчисления"
    },
    "description": "назначение социальные отчисления. Обязательные социальные отчисления",
    "paymentAmount": {
      "amount": 1977.00,
      "currency": "KZT"
    },
    "urgent": false,
    "payerIban": "KZ11111AAA1111111111",
    "documentId": "23",
    "factualSender": null
  },
  "paymentEmployees": [
    {
      "iin": "71111111111",
      "lastName": "ТЕСТ",
      "firstName": "ТЕСТ",
      "middleName": "ТЕСТОВИЧ",
      "paymentAmount": {
        "amount": 777,
        "currency": "KZT"
      },
      "period": "2025-09",
      "birthDate": "1971-10-17"
    }
  ]
}
№ Параметр Тип данных Обязательность Описание
1 type string Да Тип платежа.

Значения:
PENSION - Пенсионный платеж
SOCIAL - Социальный платеж
SPECIAL_SOCIAL - Специальные социальные выплаты
MEDICAL - ОСМС (Обязательное социальное медицинское страхование)
2 category string Да Категория платежа.

Может принимать только значение DOMESTIC - Платежи в тенге
3 paymentRecipient object Да Информация о получателе
3.1 iinOrBin string Да БИН получателя.

Может принимать только 12 цифровых символов
3.2 name string Да Наименование получателя.

Не должен превышать 200 символов
3.3 kbe object Да КБЕ.

Для корректности заполнения по данному параметру используйте методы из справочника
3.3.1 code string Да Код КБЕ.

Может принимать только 2 цифровых символа
3.4 recipientAccount object Да Счет получателя
3.4.1 iban string Да Номер счета получателя.

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
3.4.2 bankName string Да Наименование банка/бюджетной организации.

Не должен превышать 200 символов
3.4.3 bic string Да БИК банка получателя.

Должен принимать соответствующий БИК банка. Содержит только 8 заглавных букв и цифр
4 details object Да Детальная информация
4.1 knp object Да КНП.

Для корректности заполнения по данному параметру используйте методы из справочника
4.1.1 code string Да Код КНП.

Содержит только 3 цифры
4.1.2 name string Нет Название кода КНП.

Может содержать буквы и цифры. Не должен превышать 200 символов
4.2 description string Да Назначение платежа.

Может принимать буквы и цифры. Не должен превышать 480 символов
4.3 paymentAmount object Да Сумма платежа
4.3.1 amount number Да Сумма.

Сумма больше 0, не больше 1 000 000 000 000. Не превышает 2-ух знаков после запятой
4.3.2 currency string Да Валюта.

Должно быть равно KZT
4.4 urgent boolean Да Отметка срочности платежа.

Если платеж до 16.00 часов, то можно указать признак срочности. При указании значения true комиссия за проведение срочного платежа будет списана согласно тарифному плану.
Если платеж после 16.00 часов, то признак срочности не активен.
4.5 payerIban string Да Номер счета плательщика.

Содержит буквы и цифры, всегда начинается с KZ, не должен превышать 20 символов
4.6 documentId string Да Номер документа плательщика.

Может содержать буквы и цифры, не должен превышать 50 символов
4.7 factualSender object Да Фактический отправитель.

При уплате платежей в бюджет за свое обособленное подразделение укажите в параметре factualSender наименование этого подразделения, а также его БИН
4.7.1 iinOrBin string Да БИН своего обособленного подразделения - фактического отправителя.

Может принимать только 12 цифровых символов.
Для нерезидентов допускаются значение 000000000000
4.7.2 name string Да Название своего обособленного подразделения - фактического отправителя.

Может содержать только буквы и цифры. Не должен превышать 250 символов
5 paymentEmployees arrayOfObjects Да Список сотрудников к платежу
5.1 paymentAmount object Да Сумма платежа (по сотруднику)
5.1.1 amount number Да Сумма.

Сумма больше 0, меньше 1 000 000 000 000. Не превышает 2-ух знаков после запятой
5.1.2 currency string Да Валюта.

Должно быть равно KZT
5.2 birthDate string Да Дата рождения.

Указывается дата в формате YYYY-MM-DD
5.3 iin string Да ИИН.

Может принимать только 12 цифровых символов
5.4 lastName string Нет Фамилия сотрудника.

Не должен превышать 200 символов
5.5 firstName string Да Имя сотрудника.

Не должен превышать 200 символов
5.6 middleName string Нет Отчество сотрудника.

Не должен превышать 200 символов
5.7 period string Да Платежный период.

Указывать период в формате YYYY-MM

Сформированный payload платежа подписать ЭЦП. Подробнее вы можете ознакомиться в Инструкции по использованию NCALayer.
Затем сформировать запрос к методу — Выполнить перевод между своими текущими счетами.

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

Request Body schema: application/json
required
content
required
string <JWS, base64url-encoded>

Сведения о платеже, подписанные ЭЦП

Responses

Request samples

Content type
application/json
{
  • "content": "eyJzcGFuaWQiOiI4NzJjMWEyNTg4NDQxYTU3ZmRkZjFmYzZhMjY5NTg5NzI1MTdjMjNlMzU3MTIyZjI0ZTY4Nzg0YmJiMjNmZmUyIiwiY3R5IjoiYXBwbGljYXRpb24vanNvbiIsInR5cCI6IkpPU0UiLCJhbGciOiJFQ0dPU1QzNDEwLTIwMTUtNTEyIiwidHMiOiIxNzY1ODE2OTQ1OTUyIiwieDVjIjpbIk1JSUV2RENDQkNTZ0F3SUJBZ0lRV0t3cEFyLy93OCs5OE9TcThucnQ1ekFPQmdvcWd3NERDZ0VCQWdNQ0JRQXdSekVqTUNFR0ExVUVBd3dhVFhrZ1EyOXRjR0Z1ZVNCSmJuUmxjbTFsWkdsaGRHVWdRMEV4RXpBUkJnTlZCQW9NQ2sxNUlFTnZiWEJoYm5reEN6QUpCZ05WQkFZVEFrdGFNQjRYRFRJMU1Ea3dNakE1TURVek5Wb1hEVEkyTURrd01qQTVNRFV6TlZvd2dmWXhSekJGQmdOVkJBTU1QdENVMExqUmdOQzEwTHJSZ3RDKzBZRFF2dEN5SU5DVTBMalJnTkMxMExyUmd0QyswWUFnMEpUUXVOR0EwTFhRdXRHQzBMN1JnTkMrMExMUXVOR0hNUjB3R3dZRFZRUUVEQlRRbE5DNDBZRFF0ZEM2MFlMUXZ0R0EwTDdRc2pFWU1CWUdBMVVFQlJNUFNVbE9PRGd4TWpJeU1EVXdOVFEwTVFzd0NRWURWUVFHRXdKTFdqRW9NQ1lHQTFVRUNnd2YwS0xRbnRDZUlOQ2cwTDdRczlDd0lOQzRJTkNhMEw3UXY5R0wwWUxRc0RFWU1CWUdBMVVFQ3d3UFFrbE9NVE13TlRRd01ERTRPREU1TVNFd0h3WURWUVFxREJqUWxOQzQwWURRdGRDNjBZTFF2dEdBMEw3UXN0QzQwWWN3Z2F3d0l3WUpLb01PQXdvQkFRSUNNQllHQ2lxRERnTUtBUUVDQWdFR0NDcUREZ01LQVFNREE0R0VBQVNCZ04wVjFydHI4bHcySXRJTFFTUGlyRXFyc2k2OHBJM2xjR0NJMFFaN3hRbXNqQkM1MWpuVXF6N2tlcVR2SGNMbCtXbXJiM0Ntdmd6aVdicmU1a3VPMThEMUlWd3FGdVdqaVFQNytpVG9GLzZOVms1azM1OFY3REs0ckdrbTdmMnVPNm1oT2oyeUlIM1hXbzY3aWt2MEFQS0FGWVRBZWJTT050ZGU4aGJuTDhwU280SUI2RENDQWVRd0h3WURWUjBqQkJnd0ZvQVVzU1p3YXdyUTZETENrdzRjVWN3SDk0Z3RENGt3SFFZRFZSME9CQllFRkl2d3duYlY4TG5BODlrMm85bjU5dXRLVE1HS01BNEdBMVVkRHdFQi93UUVBd0lHd0RBb0JnTlZIU1VFSVRBZkJnZ3JCZ0VGQlFjREJBWUlLb01PQXdNRUFRSUdDU3FERGdNREJBRUNBakE0QmdOVkhTQUVNVEF2TUMwR0JpcUREZ01EQWpBak1DRUdDQ3NHQVFVRkJ3SUJGaFZvZEhSd09pOHZjR3RwTG1kdmRpNXJlaTlqY0hNd2RRWUlLd1lCQlFVSEFRRUVhVEJuTUNnR0NDc0dBUVVGQnpBQmhoeG9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDI5amMzQXZNRHNHQ0NzR0FRVUZCekFDaGk5b2RIUndPaTh2ZEdWemRDNXdhMmt1WjI5MkxtdDZMMk5sY25RdmFXNTBaWEp0WldScFlYUmxYMk5oTG1ObGNqQS9CZ05WSFI4RU9EQTJNRFNnTXFBd2hpNW9kSFJ3T2k4dmRHVnpkQzV3YTJrdVoyOTJMbXQ2TDJOeWJDOXBiblJsY20xbFpHbGhkR1ZmWTJFdVkzSnNNRUVHQTFVZExnUTZNRGd3TnFBMG9ES0dNR2gwZEhBNkx5OTBaWE4wTG5CcmFTNW5iM1l1YTNvdlkzSnNMMmx1ZEdWeWJXVmthV0YwWlY5allWOWtMbU55YkRBYkJnTlZIUkVFRkRBU2dSQjFjMlZ5UUdWNFlXMXdiR1V1WTI5dE1CWUdCaXFERGdNREJRUU1NQW9HQ0NxRERnTURBd0VCTUE0R0NpcUREZ01LQVFFQ0F3SUZBQU9CZ1FBbVdqUCtPaERMb0VYMiszeDQzYlVEakJuVFpTN0VDNEJjczNRVW5Oc28wMXNBTTYwc2xrMXBRblJaL091ZG9TeEVpTzNZSmt0UEFncnJiSG04YjlwWXZQSjNsNUh2QjhQUTF0NkszditzV0kzdDBZa1g5aVhHa2VIOTdlT2dheUZhOFRvOUVVZThQeHlNcTk0MGJIY0srQi9TQXUydG9DUDFVTVZVMEM4SEdRPT0iXX0.eyJjYXRlZ29yeSI6ICJET01FU1RJQyIsICJ0eXBlIjogIlNPQ0lBTCIsICJwYXltZW50UmVjaXBpZW50IjogeyJpaW5PckJpbiI6ICIxNjA0NDAwMDcxNjEiLCAibmFtZSI6ICLQndCQ0J4gXCLQk9C-0YHRg9C00LDRgNGB0YLQstC10L3QvdCw0Y8g0LrQvtGA0L_QvtGA0LDRhtC40Y8gwqvQn9GA0LDQstC40YLQtdC70YzRgdGC0LLQviDQtNC70Y8g0LPRgNCw0LbQtNCw0L1cIiIsICJrYmUiOiB7ImNvZGUiOiAiMTEifSwgInJlY2lwaWVudEFjY291bnQiOiB7ImliYW4iOiAiS1oxMjAwOU5QUzA0MTM2MDk4MTYiLCAiYmFua05hbWUiOiAi0J3QkNCeIFwi0JPQvtGB0YPQtNCw0YDRgdGC0LLQtdC90L3QsNGPINC60L7RgNC_0L7RgNCw0YbQuNGPIMKr0J_RgNCw0LLQuNGC0LXQu9GM0YHRgtCy0L4g0LTQu9GPINCz0YDQsNC20LTQsNC9XCIiLCAiYmljIjogIkdDVlBLWjJBIn19LCAiZGV0YWlscyI6IHsia25wIjogeyJjb2RlIjogIjAxMiIsICJuYW1lIjogItCe0LHRj9C30LDRgtC10LvRjNC90YvQtSDRgdC-0YbQuNCw0LvRjNC90YvQtSDQvtGC0YfQuNGB0LvQtdC90LjRjyJ9LCAiZGVzY3JpcHRpb24iOiAi0L3QsNC30L3QsNGH0LXQvdC40LUg0YHQvtGG0LjQsNC70YzQvdGL0LUg0L7RgtGH0LjRgdC70LXQvdC40Y8uINCe0LHRj9C30LDRgtC10LvRjNC90YvQtSDRgdC-0YbQuNCw0LvRjNC90YvQtSDQvtGC0YfQuNGB0LvQtdC90LjRjyIsICJwYXltZW50QW1vdW50IjogeyJhbW91bnQiOiAxOTc3LCAiY3VycmVuY3kiOiAiS1pUIn0sICJ1cmdlbnQiOiBmYWxzZSwgInBheWVySWJhbiI6ICJLWjExMTExQUFBMTExMTExMTExMSIsICJkb2N1bWVudElkIjogIjIzIiwgImZhY3R1YWxTZW5kZXIiOiBudWxsfSwgInBheW1lbnRFbXBsb3llZXMiOiBbeyJpaW4iOiAiNzExMTExMTExMTExIiwgImxhc3ROYW1lIjogItCi0JXQodCiIiwgImZpcnN0TmFtZSI6ICLQotCV0KHQoiIsICJtaWRkbGVOYW1lIjogItCi0JXQodCi0J7QktCY0KciLCAicGF5bWVudEFtb3VudCI6IHsiYW1vdW50IjogNzc3LCAiY3VycmVuY3kiOiAiS1pUIn0sICJwZXJpb2QiOiAiMjAyNS0wOSIsICJiaXJ0aERhdGUiOiAiMTk3MS0xMC0xNyJ9XX0.nTq8p-tDrUCQ6Ow4oEk7szuE6zPsHSyxSxZ5kcTjVvUbOoBAImwXNP2NmMV1DqEKU6dcNv1sI0piL7BHa6KMe6NEdq_D-8E67_IJe_O2D5o41Llkbvep5EW_c4RWNIJDp2kArxhMbq2cTfOBkvUc9PsicHYA8Na13j41lEo9m3Y"
}

Response samples

Content type
application/json
Example
{
  • "type": "PENSION",
  • "category": "DOMESTIC",
  • "payment": {
    }
}

Получить статус платежа

Метод предназначен для получения статуса платежа, выполненного с помощью методов из раздела "Платежи и переводы".

Authorizations:
Bearer
path Parameters
companyId
string <uuid>
Example: 333a4b56-7d8e-90ab-12c3-a1b123456ddb

Уникальный идентификатор компании, к которой привязано приложение — клиент Business API. Получить идентификатор можно в запросе аутентификации.

operationId
string <uuid>
Example: 1f5f7806-8951-4d89-8734-727f38b31cb2

Уникальный идентификатор платежа в рамках компании. Генерируется на стороне Business API.

Responses

Response samples

Content type
application/json
{
  • "operationId": "1f5f7806-8951-4d89-8734-727f38b31cb2",
  • "status": {
    }
}

Справочники

В данном разделе содержатся методы, с помощью которых вы можете получить информацию о кодах КНП и КБЕ, а также реквизиты банков Казахстана. Эта информация может быть использована при создании платежей.

Получение списка кодов: КБЕ, КНП, КБК

Метод для получения список кодов, доступен всем созданным приложениям

Authorizations:
Bearer
query Parameters
code
required
string
Enum: "KBE" "KNP" "KBK"

Код для получения доменных значений (возможные значения: КБЕ, КНП, КБК)

Responses

Response samples

Content type
application/json
[
  • {
    }
]

Получение списка банков с реквизитами

Метод для получения списка банков, доступен всем созданным приложениям

Authorizations:
Bearer

Responses

Response samples

Content type
application/json
[
  • {
    }
]