Создать запрос на добавление реквизитов типа CARD для бенефициара
https://secured-openapi.tbank.ru/api/v1/nominal-accounts/beneficiaries/{beneficiaryId}/add-card-requests
Создает запрос на добавление реквизитов типа CARD для бенефициара и возвращает его с ID, который нужен для дальнейшего взаимодействия.
Ограничение на использование метода — 10 запросов в секунду.
Чтобы использовать метод, нужен доступ 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
Required
terminalKey
String
Requirements: non-empty and <= 256 characters
Ключ терминала.
Ответ
Это полезный материал?
Пример запроса
Payload
cURL
Go
Java
NodeJs
PHP
Python
Content type
application/json
{
"terminalKey":
"1573803282696E2C"
}
Пример ответа
Content type
application/json
{
"beneficiaryId":
"61f656e0-0a86-4ec2-bd43-232499f7ad66",
"addCardRequestId":
"49e46893-9a7e-409b-8c79-647aecaae555",
"terminalKey":
"1573803282696E2C",
"status":
"PENDING",
"addCardUrl":
"https://securepay.tinkoff.ru/e2c/f36d8e7f-4bc6-4250-9f64-7fe986d3dc62"
}