Создание перевода контрагенту
Создаёт платёж типа «Платёжное поручение» для перевода контрагенту. В поле domesticTransferType передаётся PaymentOrder.
| 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 = PaymentOrder |
number | String | Условно | Номер документа (валидируется constraint number) |
amount | BigDecimal | Да | Сумма платежа (проверка лимитов и max sum) |
senderResidencyCountry.twoLetterCode | String | Да | Код страны отправителя |
senderResidencyCountry.name | String | Нет | Наименование страны отправителя |
actualSender.taxCode | String | Нет | БИН/ИИН фактического отправителя |
actualSender.name | String | Нет | Имя фактического отправителя |
actualSender.type | enum (ActualSenderType) | Нет | Тип (DEBTOR) |
paymentSource | enum (PaymentSource) | — | Вычисляется сервером (V2 / FACTORING) |
valueDate | LocalDate (yyyy-MM-dd) | Условно | Дата валютирования |
purpose.code | String | Да | Код назначения платежа (КНП) |
purpose.label | String | Нет | Текст назначения платежа |
priority | boolean | Нет | Признак срочности |
vatAmount | BigDecimal | Нет | Сумма НДС |
info | String | Нет | Доп. информация по назначению |
account.currency | String | Да | Валюта счёта |
account.number | String | Да | IBAN счёта |
account.alias | String | Нет | Псевдоним |
account.balance | BigDecimal | Нет | Баланс |
account.type | enum AccountType | Да | Тип счёта |
beneficiary.account | String | Да | IBAN получателя |
beneficiary.name | String | Да | Наименование получателя |
beneficiary.bankCode | String | Нет | Код банка |
beneficiary.taxCode | String | Да | БИН/ИИН получателя |
beneficiary.bankName | String | Нет | Банк получателя |
beneficiary.bankBIC | String | Нет | BIC банка |
beneficiary.residencyAndEconomicCode | String | Да | КБе |
beneficiary.counterpartyId | Long | Нет | ID контрагента |
beneficiary.residencyCountryCode.twoLetterCode | String | Да | Страна получателя (код) |
beneficiary.residencyCountryCode.name | String | Нет | Страна получателя (название) |
beneficiary.actualBeneficiary.taxCode | String | Нет | БИН/ИИН фактического получателя |
beneficiary.actualBeneficiary.name | String | Нет | Имя фактического получателя |
kvo.code | String | Условно | Код валютной операции |
kvo.label | String | Условно | Наименование КВО |
subsidiary.subsidiaryOrganizationId | Long | Нет | ID дочерней организации |
isNotNeedUnc | Boolean | Нет | Не требуется УНК |
isPermitGiveInformation | Boolean | Нет | Согласие на предоставление информации |
isLoanPay | boolean | Нет (default false) | Погашение кредита |
Пример тела запроса
{
"account": {
"type": "Current",
"currency": "KZT",
"number": "KZ11111111111KZ11111",
"externalId": "KZ11111111111KZ11111",
"alias": "111111111111",
"balance": 111111111.1
},
"actualSender": null,
"amount": 11111,
"beneficiary": {
"account": "KZ111111111111111111",
"actualBeneficiary": null,
"bankBIC": "KCJBKZKX",
"bankCode": "856",
"bankName": "АО \"Банк \"",
"counterpartyId": 111111,
"name": "ТОО \"Test\"",
"residencyAndEconomicCode": "11",
"residencyCountryCode": {
"twoLetterCode": "KZ",
"name": "КАЗАХСТАН"
},
"taxCode": "111111111111"
},
"domesticTransferType": "PaymentOrder",
"info": "",
"isLoanPay": false,
"isNotNeedUnc": false,
"isPermitGiveInformation": false,
"kvo": null,
"number": "1111111111",
"priority": false,
"purpose": {
"code": "710",
"label": "Платежи за товары, за исключением недвижимости и товаров с кодами назначения платежа 711, 712 и 713"
},
"senderResidencyCountry": {
"twoLetterCode": "KZ",
"name": "КАЗАХСТАН"
},
"subsidiary": null,
"valueDate": "2026-06-09",
"vatAmount": null
}
Тело ответа
| Поле | Тип | Описание |
|---|---|---|
paymentId | Long | Идентификатор созданного платежа |
Коды ошибок
Ошибки:
| Код | Условие |
|---|---|
| 400 Bad Request | Невалидный JSON / неизвестный domesticTransferType / нарушение констрейнтов полей |
| 401 Unauthorized | Отсутствует/невалиден JWT |
| 403 Forbidden | Нет доступа (нет привилегии) |
| 400 / бизнес-ошибки валидации | Возвращаются как ValidationExceptionResponse (список ошибок по полям, формируемый стратегией валидации) |
Пример ошибки валидации
{
"validationExceptions": [
{
"fieldName": "actualBeneficiaryTaxCode",
"translationKey": "validation.v1.actual_beneficiary_tax_code_format_not_correct",
"message": "Actual Beneficiary tax code format not correct",
"translatedMessage": "ИИН/БИН фактического получателя указан в неправильном формате"
}
]
}
Необходимые привилегии
-
payments_add -
payments_view -
payments_edit -
privilege_counterparty_view
Следующие действия
Инициализация подписания → подписание с синхронной отправкой в АБС. Результат доступен через получение платежа.