Перейти к основному содержимому
Версия: 2026.09.1

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

Создаёт перевод между своими счетами. Передайте domesticTransferType=OwnAccountTransfer.

EndpointPOST /domestic-payment-service/api/v1/external-payment
Content-Typeapplication/json
АвторизацияOAuth2 / JWT (Bearer token)

Query/Path-параметры не требуются.

Тело запроса​

ПолеТипОбязательностьОписание
idLongНетИдентификатор платежа. При создании не передаётся, используется при обновлении
domesticTransferTypeenum (DomesticTransferType)ДаТип платежа. Для API = OwnAccountTransfer
numberStringУсловноНомер документа (валидируется constraint number)
amountBigDecimalДаСумма платежа (проверка лимитов и max sum)
purpose.codeStringНетКНП
paymentSourceenum (PaymentSource)—Вычисляется сервером (V2 / FACTORING)
valueDateLocalDate (yyyy-MM-dd)УсловноДата валютирования
fromAccountNumberStringДаНомер счета отправителя
toAccountNumberStringДаНомер счета получателя
fromAccount.idLongНетИспользуется для определение счета корпоративных карт
fromAccount.currencyStringДаВалюта счёта
fromAccount.numberStringДаIBAN счёта
fromAccount.aliasStringНетПсевдоним
fromAccount.balanceBigDecimalНетБаланс
fromAccount.typeenum AccountTypeДаТип счёта (проверка ограничений по счетам)
toAccount.idLongНетИспользуется для определение счета корпоративных карт
toAccount.currencyStringДаВалюта счёта
toAccount.numberStringДаIBAN счёта
toAccount.aliasStringНетПсевдоним
toAccount.balanceBigDecimalНетБаланс
toAccount.typeenum AccountTypeДаТип счёта (проверка ограничений по счетам)

Типы счетов​

КодНаименование
CurrentТекущий счет
DepositДепозитный счет
Credit—
CardКорпоративная карта
Loro—
BrokerageБрокерский счет
KSNDS—
CUSTODIANКастодиальный счет
SSPO—

Пример тела запроса​

Реквизиты и суммы в примере условные. Замените их актуальными значениями.

{
"number": "1",
"amount": 11,
"valueDate": "2026-07-13",
"purpose": {
"code": "690"
},
"fromAccount": {
"id": 22075,
"number": "KZ11111111111KZ11111",
"currency": "KZT",
"type": "Current"
},
"toAccount": {
"id": 11111,
"number": "KZ11111111111KZ11111",
"currency": "KZT",
"type": "Brokerage"
},
"fromAccountNumber": "KZ11111111111KZ11111",
"toAccountNumber": "KZ11111111111KZ11111",
"domesticTransferType": "OwnAccountTransfer"
}

Тело ответа​

ПолеТипОписание
paymentIdLongИдентификатор созданного платежа

Коды ошибок​

Ошибки:

КодУсловие
400 Bad RequestНевалидный JSON / неизвестный domesticTransferType / нарушение констрейнтов полей
401 UnauthorizedОтсутствует/невалиден JWT
403 ForbiddenНет доступа (нет привилегии)
400 / бизнес-ошибки валидацииВозвращаются как ValidationExceptionResponse (список ошибок по полям, формируемый стратегией валидации)

Необходимые привилегии​

  • payments_add

  • payments_view

  • payments_edit

  • privilege_counterparty_view

Следующие действия​

Инициализация подписания → подписание с синхронной отправкой в АБС. Результат доступен через получение платежа.