Перевод между своими счетами
Создаёт перевод между своими счетами. Передайте domesticTransferType=OwnAccountTransfer.
| Endpoint | POST /domestic-payment-service/api/v1/external-payment |
| Content-Type | application/json |
| Авторизация | OAuth2 / JWT (Bearer token) |
Query/Path-параметры не требуются.
Тело запроса
| Поле | Тип | Обязательность | Описание |
|---|---|---|---|
id | Long | Нет | Идентификатор платежа. При создании не передаётся, используется при обновлении |
domesticTransferType | enum (DomesticTransferType) | Да | Тип платежа. Для API = OwnAccountTransfer |
number | String | Условно | Номер документа (валидируется constraint number) |
amount | BigDecimal | Да | Сумма платежа (проверка лимитов и max sum) |
purpose.code | String | Нет | КНП |
paymentSource | enum (PaymentSource) | — | Вычисляется сервером (V2 / FACTORING) |
valueDate | LocalDate (yyyy-MM-dd) | Условно | Дата валютирования |
fromAccountNumber | String | Да | Номер счета отправителя |
toAccountNumber | String | Да | Номер счета получателя |
fromAccount.id | Long | Нет | Используется для определение счета корпоративных карт |
fromAccount.currency | String | Да | Валюта счёта |
fromAccount.number | String | Да | IBAN счёта |
fromAccount.alias | String | Нет | Псевдоним |
fromAccount.balance | BigDecimal | Нет | Баланс |
fromAccount.type | enum AccountType | Да | Тип счёта (проверка ограничений по счетам) |
toAccount.id | Long | Нет | Используется для определение счета корпоративных карт |
toAccount.currency | String | Да | Валюта счёта |
toAccount.number | String | Да | IBAN счёта |
toAccount.alias | String | Нет | Псевдоним |
toAccount.balance | BigDecimal | Нет | Баланс |
toAccount.type | enum 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"
}
Тело ответа
| Поле | Тип | Описание |
|---|---|---|
paymentId | Long | Идентификатор созданного платежа |
Коды ошибок
Ошибки:
| Код | Условие |
|---|---|
400 Bad Request | Невалидный JSON / неизвестный domesticTransferType / нарушение констрейнтов полей |
401 Unauthorized | Отсутствует/невалиден JWT |
| 403 Forbidden | Нет доступа (нет привилегии) |
400 / бизнес-ошибки валидации | Возвращаются как ValidationExceptionResponse (список ошибок по полям, формируемый стратегией валидации) |
Необходимые привилегии
-
payments_add -
payments_view -
payments_edit -
privilege_counterparty_view
Следующие действия
Инициализация подписания → подписание с синхронной отправкой в АБС. Результат доступен через получение платежа.