Получение платежа (v2)

Возвращает один платёж (внутренний перевод, DomesticTransfer) по его идентификатору вместе с актуальным набором доступных действий (actions), рассчитанным под текущий статус документа, тип перевода, продукт и канал создания. Используется как для веб-/мобильного клиента (карточка платежа), так и интеграционными потребителями (например, ядром Core — через source=CORE).

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

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

Используется для проверки статуса после создания и подписания.

Параметры запроса

Параметр	Расположение	Тип	Обяз.	Описание
id	path	Long	Да	Идентификатор платежа. Трактуется по-разному в зависимости от source
source	query	String	Нет	Источник вызова. Если CORE — id интерпретируется как внешний идентификатор (kafkaExternalId), иначе — как первичный ключ платежа (payment.id)

Тело запроса отсутствует.

Ответ

Поле	Тип	Описание
id	number	Идентификатор платежа
domesticTransferType	string	Тип внутреннего перевода
number	string	Номер платёжного документа
amount	number	Сумма перевода
senderResidencyCountry.twoLetterCode	string	Код страны отправителя (2 буквы)
senderResidencyCountry.name	string	Наименование страны отправителя
status.name	string	Внутренний статус документа
status.label	string	Текстовое описание статуса
status.info	string	Доп. информация о статусе
actualSender	object	Фактический отправитель (null, если не задан)
actions[].state	string	Доступное действие
actions[].name	string	Наименование действия
valueDate	string	Дата валютирования
purpose.code	string	Код назначения
purpose.label	string	Текстовое описание назначения
source	string	Источник создания документа
created	string	Дата создания документа
priority	boolean	Приоритет платежа
vatAmount	number	Сумма НДС (null, если не указана)
info	string	Доп. информация
account.id	number	Идентификатор счёта
account.status	string	Статус счёта
account.currency	string	Валюта счёта
account.number	string	Номер счёта (IBAN)
account.alias	string	Псевдоним счёта
account.balance	number	Баланс
account.type	string	Тип счёта
beneficiary.account	string	Счёт получателя
beneficiary.name	string	Наименование получателя
beneficiary.bankCode	string	Код банка
beneficiary.taxCode	string	ИИН/БИН получателя
beneficiary.bankName	string	Наименование банка
beneficiary.bankBIC	string	BIC банка
beneficiary.residencyAndEconomicCode	string	Код резидентности/экономики
beneficiary.residencyCountryCode.twoLetterCode	string	Код страны получателя
beneficiary.residencyCountryCode.name	string	Наименование страны получателя
sender.taxCode	string	ИИН/БИН отправителя
sender.name	string	Наименование отправителя
subsidiary	object	Филиал (null, если не указан)
feeAmount	number	Комиссия
referenceNumber	string	Референс документа
template	boolean	Признак шаблона
raw	boolean	Признак «черновика»
readonly	boolean	Признак «только для чтения»

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

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

cURL

curl --location \
  'https://api-test.business-t.berekebank.kz/domestic-payment/api/v2/payments/1001' \
  --header 'Authorization: Bearer <token>'

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

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

200 OK

{
  "id": 1001,
  "domesticTransferType": "PaymentOrder",
  "number": "1000001",
  "amount": 10010,
  "senderResidencyCountry": { "twoLetterCode": "KZ", "name": "КАЗАХСТАН" },
  "status": { "name": "SIGNED", "label": "Подписан", "info": null },
  "actualSender": null,
  "actions": [
    { "state": "details", "name": "Просмотр" },
    { "state": "history", "name": "История" }
  ],
  "valueDate": "2026-06-09",
  "purpose": { "code": "710", "label": "Платежи за товары" },
  "source": "WEB",
  "created": "2026-06-09T11:14:00",
  "priority": false,
  "vatAmount": null,
  "info": "",
  "account": {
    "id": 101,
    "status": "ACTIVE",
    "currency": "KZT",
    "number": "KZ00000KZT0000000000",
    "alias": "Основной счёт",
    "balance": 643608017.5,
    "type": "Current"
  },
  "beneficiary": {
    "account": "KZ00000KZT0000000001",
    "name": "ТОО «Ромашка»",
    "bankCode": "998",
    "taxCode": "190940000029",
    "bankName": "АО «Демо Банк Плюс»",
    "bankBIC": "DEMOKZK2",
    "residencyAndEconomicCode": "11",
    "residencyCountryCode": { "twoLetterCode": "KZ", "name": "КАЗАХСТАН" }
  },
  "sender": { "taxCode": "210840000011", "name": "АО «Демо Трейд»" },
  "subsidiary": null,
  "feeAmount": 0,
  "referenceNumber": "DEMO-REF-0001",
  "template": false,
  "raw": false,
  "readonly": false
}

Коды ошибок

Код	Условие
401 Unauthorized	Отсутствует/невалиден JWT
403 Forbidden	Нет доступа (нет привилегии)

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

Достаточно любой из: payments_view, payments_edit, m_dompayments_view, m_transfers_view.