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

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

Создаёт платёж типа «Платёжное поручение» для перевода контрагенту. В поле domesticTransferType передаётся PaymentOrder.

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

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

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

ПолеТипОбязательностьОписание
idLongНетИдентификатор платежа. При создании не передаётся, используется при обновлении
domesticTransferTypeenum (DomesticTransferType)ДаТип платежа. Для API = PaymentOrder
numberStringУсловноНомер документа (валидируется constraint number)
amountBigDecimalДаСумма платежа (проверка лимитов и max sum)
senderResidencyCountry.twoLetterCodeStringДаКод страны отправителя
senderResidencyCountry.nameStringНетНаименование страны отправителя
actualSender.taxCodeStringНетБИН/ИИН фактического отправителя
actualSender.nameStringНетИмя фактического отправителя
actualSender.typeenum (ActualSenderType)НетТип (DEBTOR)
paymentSourceenum (PaymentSource)—Вычисляется сервером (V2 / FACTORING)
valueDateLocalDate (yyyy-MM-dd)УсловноДата валютирования
purpose.codeStringДаКод назначения платежа (КНП)
purpose.labelStringНетТекст назначения платежа
prioritybooleanНетПризнак срочности
vatAmountBigDecimalНетСумма НДС
infoStringНетДоп. информация по назначению
account.currencyStringДаВалюта счёта
account.numberStringДаIBAN счёта
account.aliasStringНетПсевдоним
account.balanceBigDecimalНетБаланс
account.typeenum AccountTypeДаТип счёта
beneficiary.accountStringДаIBAN получателя
beneficiary.nameStringДаНаименование получателя
beneficiary.bankCodeStringНетКод банка
beneficiary.taxCodeStringДаБИН/ИИН получателя
beneficiary.bankNameStringНетБанк получателя
beneficiary.bankBICStringНетBIC банка
beneficiary.residencyAndEconomicCodeStringДаКБе
beneficiary.counterpartyIdLongНетID контрагента
beneficiary.residencyCountryCode.twoLetterCodeStringДаСтрана получателя (код)
beneficiary.residencyCountryCode.nameStringНетСтрана получателя (название)
beneficiary.actualBeneficiary.taxCodeStringНетБИН/ИИН фактического получателя
beneficiary.actualBeneficiary.nameStringНетИмя фактического получателя
kvo.codeStringУсловноКод валютной операции
kvo.labelStringУсловноНаименование КВО
subsidiary.subsidiaryOrganizationIdLongНетID дочерней организации
isNotNeedUncBooleanНетНе требуется УНК
isPermitGiveInformationBooleanНетСогласие на предоставление информации
isLoanPaybooleanНет (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
}

Тело ответа​

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

Коды ошибок​

Ошибки:

КодУсловие
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

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

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