Шаг 1. Выпустить токен
Токен — это уникальный ключ доступа, который позволяет использовать методы Tinkoff API.
С помощью Self-сценария Tinkoff API вы можете выпустить Access Token — он нужен только для прямой интеграции. Токен действует 90 дней с последнего использования. При постоянном использовании токен активен бессрочно.
Чтобы использовать защищённые методы , выпустите MTLS сертификат.
В личном кабинете выберите Интеграции.
На вкладке Tinkoff API нажмите Выпуск токена.
Введите IP-адреса всех компьютеров, с которых будете использовать токен. Если вы работаете с разных компьютеров и у вас больше одного IP-адреса, введите их через запятую.
Требования к IP-адресам:
- IP-адрес должен быть статичным.
- Поддерживаются протоколы IPv4 и IPv6.
- Нельзя указывать диапазон IP-адресов.
- Максимально можно указать девять IP-адресов.
Вы можете отключить проверки IP-адресов — для этого отправьте запрос на openapi@tinkoff.ru. После отключения проверки введите любой IP в форму, например 0.0.0.0 или 1.1.1.1.
В блоке Выберите, к чему будет доступ через API выберите операции, к которым хотите дать доступ.
Нажмите Выпустить токен.
Нажмите Скопировать токен.
После этого вы можете использовать токен для подключения ваших сервисов к Tinkoff.
Отредактировать токен не получится. Чтобы изменить IP-адрес или доступы, выпустите новый токен.
Доступы
Доступ нужен, чтобы использовать методы Tinkoff API. В описании каждого метода есть шаблон доступа.
Пример
Чтобы использовать метод Получить список этапов сделки, в личном кабинете нужно выбрать доступ opensme/inn/{inn}/kpp/{kpp}/nominal-accounts/manage — Управление номинальными счетами.
Чтобы получить или изменить доступ, перевыпустите токен в личном кабинете.
Как предоставить доступ к личному кабинету своим сотрудникам
Отозвать токен
В личном кабинете перейдите в раздел Управление профилем → Настройки профиля и доступы.
Выберите вкладку Безопасность.
В блоке «Приложения, у которых есть доступ к данным для входа» выберите токен, который хотите удалить, и нажмите Удалить доступ.
