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

Создаёт платёж типа «Платёжное поручение» (внутренний перевод / платёж юрлица контрагенту).

Endpoint	POST /domestic-payment/api/v2/payments
Content-Type	application/json
Авторизация	OAuth2 / JWT (Bearer token)
Response status	200 OK

Поток платежа v2

Создание — первый шаг. Далее: инициализация подписания → подписание и отправка в АБС → получение платежа.

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)	Погашение кредита

Ответ

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

Пример запроса

Показать запрос

cURL

curl --location \
  'https://api-test.business-t.berekebank.kz/domestic-payment/api/v2/payments' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data-raw '<тело запроса см. ниже>'

Тело запроса

{
  "account": {
    "type": "Current",
    "currency": "KZT",
    "number": "KZ00000KZT0000000000",
    "externalId": "KZ00000KZT0000000000",
    "alias": "Основной счёт",
    "balance": 643608017.5
  },
  "actualSender": null,
  "amount": 10010,
  "beneficiary": {
    "account": "KZ00000KZT0000000001",
    "actualBeneficiary": null,
    "bankBIC": "DEMOKZK2",
    "bankCode": "998",
    "bankName": "АО «Демо Банк Плюс»",
    "counterpartyId": "100201",
    "name": "ТОО «Ромашка»",
    "residencyAndEconomicCode": "11",
    "residencyCountryCode": {
      "twoLetterCode": "KZ",
      "name": "КАЗАХСТАН"
    },
    "taxCode": "190940000029"
  },
  "domesticTransferType": "PaymentOrder",
  "info": "",
  "isLoanPay": false,
  "isNotNeedUnc": false,
  "isPermitGiveInformation": false,
  "kvo": null,
  "number": 1000001,
  "priority": false,
  "purpose": {
    "code": "710",
    "label": "Платежи за товары, за исключением недвижимости и товаров с кодами назначения платежа 711, 712 и 713"
  },
  "senderResidencyCountry": {
    "twoLetterCode": "KZ",
    "name": "КАЗАХСТАН"
  },
  "subsidiary": null,
  "valueDate": "2026-06-09",
  "vatAmount": null
}

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

Показать ответ

200 OK

{
  "paymentId": 1001
}

Коды ошибок

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