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

api/check-token - Проверка статуса токена

  • HTTP‑метод: POST
  • URL: /api/check-token
  • Форма взаимодействия: Сервер-сервер
  • Формат тела запроса: application/json
  • Назначение: проверка статуса ранее полученного токена платёжного средства.

URL

1
https://gateway-docs.wallet.kvell.group/api/check-token

1
/api/check-token

Структура запроса

Поле Тип Обяз. Описание
terminal str ✔ Уникальный идентификатор учетной записи ТСП в ПЦ.
token str ✔ Ранее полученный токен.
signature str ✔ Цифровая подпись запроса. Алгоритм расчёта — см. Формирование подписи.

Структура ответа

Поле Тип Обяз. Описание
token str ✔ Токен платёжного средства. Пример: SPc6efe089-1b60-49cb-94fc-908d00cbf9f2
mean_type str ✔ Тип платёжного средства (например, SBERPAY). Пример: SBERPAY
is_active str ✔ Статус токена. В JSON-ответе сериализуется как строка ACTIVE или INACTIVE (на Python-стороне это bool, сериализатор преобразует его в строку).
info Info ✔ Дополнительная информация (см. ниже).

Вложенный объект info (Info)

Поле Тип Обяз. Описание
created_at datetime Дата/время создания токена (YYYY.MM.DD HH:MM:SS). Пример: 2023.07.24 13:17:40.565

Пример ответов

{
    "token": "SPc6efe089-1b60-49cb-94fc-908d00cbf9f2",
    "mean_type": "SBERPAY",
    "is_active": "ACTIVE",
    "info": {
        "created_at": "2023.07.24 13:17:40.565"
    }
}

{
    "error_code": "TERMINAL_NOT_FOUND",
    "technical_message": "Terminal not found",
    "timestamp": 1751976000,
    "details": null,
    "request_id": "b3b3c1f0-4b3a-4f3a-9b1a-1234567890ab"
}

Примечания

  • По причине ряда ограничений с проверкой токена СБП, данный метод может отдавать данные о неактивности платежного средства. Рекомендуется проверять валидность токена через попытку оплаты по токену соответствующего метода для платежного средства.