Создать банковские реквизиты для бенефициара
https://secured-openapi.tbank.ru/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/bank-details
Создаёт банковские реквизиты для бенефициара и возвращает их с ID, который нужен для дальнейшего взаимодействия.
Ограничение на использование метода — 10 запросов в секунду.
С помощью метода можно создать реквизиты типов PAYMENT_DETAILS, CARD и SBP.
Добавить реквизиты типа CARD могут только партнёры с сертификатом PCI DSS.
Чтобы подключиться к методу, напишите на openapi@tinkoff.ru перед интеграцией.
Чтобы использовать метод, нужен доступ opensme/inn/[{inn}]/kpp/[{kpp}]/nominal-accounts/manage — Управление номинальными счетами.
Запрос
Header parameters
Required
Idempotency-Key
String<uuid>
Ключ идемпотентности. Подробнее.
Path parameters
Required
beneficiaryId
String<uuid>
Идентификатор бенефициара.
Request body schema application/json
- CardBankDetailsRequest
- RkcBankDetailsRequest
- SbpBankDetailsRequest
Required
type
String
Requirements: [PAYMENT_DETAILS, CARD, SBP]
Тип банковских реквизитов:
PAYMENT_DETAILS— По реквизитам счёта.CARD— На карту.SBP— Через СБП.
isDefault
Boolean
Являются ли реквизиты основными для бенефициара. По умолчанию для первых добавленных реквизитов — true, для следующих — false.
Required
terminalKey
String
Requirements: non-empty and <= 256 characters
Ключ терминала.
Required
cardData
String
Requirements: non-empty and <= 512 characters
Зашифрованные данные карты.
Объект CardData собирается в виде списка «ключ=значение» (разделитель «;») и зашифровывается открытым ключом (X509 RSA 2048). Получившееся бинарное значение кодируется в Base64.
Список значений:
PAN— обязательный параметр, номер карты. Число.ExpDate— необязательный параметр, месяц и год срока действия карты в формате MMYY. Число.CardHolder— необязательный параметр, имя и фамилия держателя карты — как на карте. Строка.CVV— необязательный параметр, код защиты с обратной стороны карты. Строка.
Пример: PAN=4300000000000777;ExpDate=0523;CardHolder=IVAN PETROV;CVV=111
Открытый ключ генерируется банком. Чтобы получить открытый ключ для шифрования CardData, напишите на acq_help@tinkoff.ru или обратитесь к сотруднику, который помогал вам с процессом выпуска терминала.
Required
type
String
Requirements: [PAYMENT_DETAILS, CARD, SBP]
Тип банковских реквизитов:
PAYMENT_DETAILS— По реквизитам счёта.CARD— На карту.SBP— Через СБП.
isDefault
Boolean
Являются ли реквизиты основными для бенефициара. По умолчанию для первых добавленных реквизитов — true, для следующих — false.
Required
bik
String
Requirements: Value must match regular expression \d{9}
БИК банка получателя.
С 1 января 2021 года при перечислении налоговых платежей указываются новые значения БИК банков получателя.
kpp
String
Requirements: Value must match regular expression ^(\d{9}|0)$
КПП получателя. Чтобы не заполнять, передайте 0. Обязательно только для бенефициаров юридических лиц-резидентов (UL_RESIDENT).
inn
String
Requirements: Value must match regular expression ^(\d{12}|\d{10}|0{1})$
ИНН бенефициара. Если платёж выполняется в пользу физического или юридического лица-нерезидента (FL_RESIDENT/FL_NONRESIDENT/UL_NONRESIDENT) и его ИНН неизвестен, передайте 0.
В остальных случаях передавайте фактический ИНН получателя.
Если у бенефициара в методе создания бенефициара был заполнен ИНН, поле ИНН заполнять не нужно.
ИНН подставляется автоматически по информации из бенефициара в момент отправки платежа. Для корректной работы передавать 0 не нужно.
name
String
Requirements: <= 160 characters
Наименование получателя.
Required
bankName
String
Requirements: non-empty and <= 160 characters
Наименование банка получателя.
Required
accountNumber
String
Requirements: Value must match regular expression ^(\d{20}|\d{22})$
Номер расчётного счёта получателя.
Required
corrAccountNumber
String
Requirements: Value must match regular expression \d{20}
Корреспондентский счёт банка получателя.
Required
type
String
Requirements: [PAYMENT_DETAILS, CARD, SBP]
Тип банковских реквизитов:
PAYMENT_DETAILS— По реквизитам счёта.CARD— На карту.SBP— Через СБП.
isDefault
Boolean
Являются ли реквизиты основными для бенефициара. По умолчанию для первых добавленных реквизитов — true, для следующих — false.
Required
terminalKey
String
Requirements: non-empty and <= 256 characters
Ключ терминала.
Required
phoneNumber
String
Requirements: Value must match regular expression ^((\+7)([0-9]){10})$
Номер мобильного телефона.
Required
bankId
String
Requirements: Value must match regular expression ^\d{12}$
Идентификатор банка в системе быстрых платежей.
Ответ
Это полезный материал?
