Изменить реципиента на этапе сделки
https://secured-openapi.tbank.ru/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients/{recipientId}
Позволяет изменить данные получателя денежных средств — реципиента (recipient) на этапе сделки. Только для сделок в статусе DRAFT.
Ограничение на использование метода — 10 запросов в секунду.
Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage — Управление номинальными счетами.
Если вы делаете перевод на реквизиты — укажите bankDetailsId. При переводе на виртуальный счет в рамках номинального счета
укажите keepOnVirtualAccount = true.
Запрос
Path parameters
Required
dealId
String<uuid>
Идентификатор сделки.
Required
stepId
String<uuid>
Идентификатор этапа сделки.
Required
recipientId
String<uuid>
Идентификатор реципиента.
Request body schema application/json
Required
beneficiaryId
String<uuid>
Идентификатор бенефициара.
Required
amount
Number
Сумма реципиента.
tax
Number
Налог реципиента.
purpose
String
Requirements: non-empty and <= 210 characters
Назначение платежа.
bankDetailsId
String<uuid>
Идентификатор банковских реквизитов.
keepOnVirtualAccount
Boolean
Вывод на виртуальный счет в рамках номинального счета — true, на реальные реквизиты — false.
При создании реципиента без банковских реквизитов, платеж в рамках сделки автоматически будет выполнен на виртуальный счет бенефициара.
Ответ
Это полезный материал?