Коды платежей денежным переводом

Public merchant API использует базовый путь /payment/v1/money-transfers и header merchantId для указанных операций.

Создание кода

Вызовите POST /payment/v1/money-transfers/code. JSON-тело содержит price (обязательно, положительное значение, максимум 2 000 000), currency (обязательно в DTO, по умолчанию TRY), token (обязательно), conversationId (необязательно, максимум 255 символов), orderId (необязательно, максимум 50 символов) и items (обязательно, 1–250 платежных позиций). В header передается merchantId.

Получение кода

Вызовите POST /payment/v1/money-transfers/retrieve с token в JSON-теле. Текущий controller не требует merchant header для этого endpoint.

Обновление кода

Вызовите POST /payment/v1/money-transfers/update с requestId и code в теле и merchantId в header.

Все три операции возвращают requestId, code, token и accountResult. Элементы accountResult.accounts содержат iban, bankCode и bankName.

В DTO создания объявлены правила Bean Validation, однако в текущем controller параметры request body не аннотированы code>@Valid</code. Интеграции должны соблюдать заявленные ограничения; runtime-проверку также следует проверить на стороне сервиса.