Создать реципиента на этапе сделки
https://secured-openapi.tbank.ru/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients
Позволяет создать получателя денежных средств — реципиента (recipient) на этапе сделки. Только для сделок в статусе DRAFT.
Ограничение на использование метода — 10 запросов в секунду.
Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage — Управление номинальными счетами.
Если вы делаете перевод на реквизиты, укажите bankDetailsId. При переводе на виртуальный счет в рамках номинального счета
укажите keepOnVirtualAccount = true.
Запрос
Header parameters
Required
Idempotency-Key
String<uuid>
Ключ идемпотентности. Подробнее.
Path parameters
Required
dealId
String<uuid>
Идентификатор сделки.
Required
stepId
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.
При создании реципиента без банковских реквизитов, платеж в рамках сделки автоматически будет выполнен на виртуальный счет бенефициара.
Ответ
Это полезный материал?