api/wallet/identification-status - Идентификация физлица

Описание

HTTP‑метод: POST
URL: /api/wallet/identification-status
Форма взаимодействия: Сервер-сервер
Формат тела запроса: application/json
Назначение: проверка документов пользователя на подлинность.

URL

URLPATH

https://gateway-docs.wallet.kvell.group/api/wallet/identification-status

/api/wallet/identification-status

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

Поле	Тип	Обяз.	Описание
`terminal`	`str`	✔	Уникальный идентификатор учетной записи ТСП в ПЦ.
`first_name`	`str`	✔	Имя физического лица.
`last_name`	`str`	✔	Фамилия физического лица.
`middle_name`	`str`	✔	Отчество физического лица.
`birth_date`	`str`	✔	Дата рождения физического лица, которое нужно идентифицировать. Формат: ГГГГ.ММ.ДД
`persondoc_number`	`str`	✔	Серия и номер паспорта физического лица.
`signature`	`str`	✔	Цифровая подпись запроса. Алгоритм расчёта — см. Формирование подписи.
Необязательные параметры
`mode`	`int`		Возможные значения: 0, 1. 0 (по умолчанию) — проверка всех документов. 1 — только проверка паспорта. (по умолчанию `0`)

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

Поле	Тип	Описание
`persondoc_result`	`str`	Результат проверки паспорта. Пример: `300 - Document validated`
`identification_state`	`str`	Статус идентификации. Пример: `INN_NOT_FOUND`
`message`	`str`	Дополнительное сообщение. Пример: `Inn not found. Check personal data`
`request_id`	`str`	Порядковый номер (идентификатор) запроса. Пример: `Inn not found. Check personal data`
`signature`	`str`	Цифровая подпись ответа ПЦ. Пример: `8f2a1c9e3b7d4056a1f8c2e9d3b6a70158fce29b4d7a1e6c0938fa2d17bc45e9`

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

Успех (200)Пример ошибки (404)

{
    "persondoc_result": "300 - Document validated",
    "signature": "8f2a1c9e3b7d4056a1f8c2e9d3b6a70158fce29b4d7a1e6c0938fa2d17bc45e9",
    "identification_state": "INN_NOT_FOUND",
    "message": "Inn not found. Check personal data",
    "request_id": "Inn not found. Check personal data"
}

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

Примечания

Запрос поддерживает только проверку паспорта физлица (mode=1) либо проверку всех документов (mode=0, по умолчанию).
Поле request_id в текущей реализации не является числовой последовательностью — оно просто отражает значение, переданное сервисом идентификации (см. пример: в тестовой среде совпадает со значением message).