Обновить банковские реквизиты у реципиента на этапе сделки

POST

https://secured-openapi.tbank.ru/api/v1/nominal-accounts/deals/{dealId}/steps/{stepId}/recipients/{recipientId}/update-bank-details

Позволяет обновить банковские реквизиты у получателя денежных средств — реципиента (recipient) при неуспешности платежа. Только для сделок в статусе PAYMENT_FAILED.

Ограничение на использование метода — 10 запросов в секунду.

Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage — Управление номинальными счетами.

Авторизация

Security

Bearer API Token

MTLS-сертификат

Запрос

Path parameters

Required

dealId

String<uuid>

Идентификатор сделки.

Required

stepId

String<uuid>

Идентификатор этапа сделки.

Required

recipientId

String<uuid>

Идентификатор реципиента.

Request body schema application/json

Required

bankDetailsId

String<uuid>

Идентификатор банковских реквизитов.

Ответ

200

400

Некорректный запрос

401

Ошибка аутентификации

403

Ошибка авторизации

422

Ошибка при обработке данных

429

Слишком много запросов

500

Ошибка сервера

Это полезный материал?

Обратиться в поддержку

Получить консультацию по интеграции