Перейти к содержанию

ДЕЙСТВУЮЩИЙ КОНТРАКТ

Авторизация

EasyTokenPay выдаёт мерчанту отдельный логин и пароль. Храните их только на серверной стороне и используйте пароль для получения токенов.

Получить токены

POST /api/v1/auth/token/login/
Content-Type: application/json

{
  "username": "service_merchant",
  "password": "secret"
}
{
  "username": "service_merchant",
  "trader": false,
  "merchant": true,
  "access_token": "...",
  "expires_in": 300,
  "refresh_expires_in": 1800,
  "refresh_token": "...",
  "token_type": "Bearer",
  "id_token": "...",
  "session_state": "...",
  "scope": "..."
}

Передавайте access token в каждом защищённом запросе:

Authorization: Bearer <access_token>

Обновить токены

POST /api/v1/auth/token/refresh/
Content-Type: application/json

{
  "refresh_token": "<refresh_token>"
}

После успешного обновления атомарно замените access token и refresh token.

Завершить сессию

POST /api/v1/auth/token/logout/
Content-Type: application/json

{
  "refresh_token": "<refresh_token>"
}

Успешный ответ: {"status":"ok"}.

HTTP Значение Действие
400 Не передано обязательное поле Исправить тело запроса
401 Неверные данные или токен неактивен Обновить токен либо проверить данные доступа
403 Мерчант отключён или запрос пришёл с неразрешённого адреса Обратиться в EasyTokenPay