3. Получение токена
На
https://myintegration.ru/auth/completeприходит запрос. Вид запроса:https://myintegration.ru/auth/complete?state=ABCxyz&code=c.1aGiAXX3Ni&session_state=hXXXXXXY3kgs3nx0H3RTj3JzCSrdaqaDhU6lS8XXXXX.i4kl6dsEB1SQogzq0Nj0Значения параметров:
state— параметр, который сгенерировал сервис партнера на шаге отправки запроса/authorize;code— параметр, нужный для получения Access Token на следующем шаге;session_state— технический параметр T‑ID.
Сервис партнера валидирует параметр
state. Если валидация прошла успешно, сохраните значение параметраcode, чтобы получать токены.Сервис партнера получает
access_tokenчерез метод POST https://id.tbank.ru/auth/token. Запрос должен выполняться с бэкенда.- Authorization: basic, где username и password соответствуют
client-idиclient_secret, который вы получили на электронную почту после регистрации. Примеры составления на разных языках. - Content-type:
application/x-www-form-urlencoded. - grant_type:
authorization_code. - redirect_uri:
https://myintegration.ru/auth/complete. - code — код из пункта 9.
- Authorization: basic, где username и password соответствуют
Сервис партнера получает ответ.
- access_token: токен для обращения к T-API для получения информации о пользователе;
- token_type: тип авторизации по
access_token; - expires_in: время жизни
access_token; - id_token: технический параметр T‑ID.
Проверить доступы
Пункт опциональный.
После получения токена мы рекомендуем проверить, что клиент предоставил нужные доступы, и партнерский сервис правильно
передал данные в scope_parameters. Для этого используйте метод POST https://id.tbank.ru/auth/introspect и
проверьте список доступов в поле scope в ответе.
- Authorization: basic, где username и password соответствуют
client-id, которые клиент получил на электронную почту после регистрации. Примеры составления на разных языках. - Content-type:
application/x-www-form-urlencoded. - token — тело токена.
В описании каждого метода T‑API есть шаблон доступа — он должен быть в поле scope полученного ответа.
С помощью полученного токена можно:
- для физических лиц — запросить данные профиля, почты и паспорта;
- для юридических лиц — создавать черновики платежных поручений компании с ИНН
9999980892и КПП999991001.