webapi/b2puser/IdentificationStatus - Идентификация физлица

Описание

HTTP‑метод: POST
URL: /webapi/b2puser/IdentificationStatus/
Форма взаимодействия: Сервер-сервер
Формат тела запроса: application/x-www-form-urlencoded
Назначение: проверка документов пользователя на подлинность.

URL

URLPATH

https://b2p.wallet.kvell.group/webapi/b2puser/IdentificationStatus/

/webapi/b2puser/IdentificationStatus/

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

Поле	Тип	Обяз.	Описание
`sector`	`str`	✔	Уникальный идентификатор учётной записи ТСП в ПЦ.
`first_name`	`str`	✔	Имя Плательщика.
`last_name`	`str`	✔	Фамилия Плательщика.
`patronymic`	`str`	✔	Отчество Плательщика.
`birth_date`	`str`	✔	Дата рождения физического лица.
`persondoc_number`	`str`	✔	Серия и номер паспорта физического лица.
`signature`	`str`	✔	Цифровая подпись (`sector`, `first_name`, `patronymic`, `last_name`, `birth_date`, `persondoc_number`, `password`).
Необязательные параметры
`mode`	`int`		Режим ответа: `0` — полный XML, `1` — только `id`.

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

Элемент	Тип	Описание
`persondoc_result`	`str`	Идентификатор заказа в ПЦ.
`identification_state`	`str`	Статус идентификации
`message`	`str`	Дополнительное сообщение.
`request_id`	`int`	Порядковый номер запроса.
`signature`	`str`	Цифровая подпись ответа ПЦ.

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

Успех (200)Ошибка валидации (400)

<?xml version="1.0" encoding="UTF-8"?>
<identification_data>
    <persondoc_result>300 - Document validated</persondoc_result>
    <signature>Y2Y0ZjllMGI3NDc0YjhjYTU2Yzk1ZTg1NGMxMmI1MDQ=</signature>
    <identification_state>INN_NOT_FOUND</identification_state>
    <message>Inn not found. Check personal data</message>
    <request_id>Inn not found. Check personal data</request_id>
</identification_data>

<?xml version="1.0" encoding="UTF-8"?>
<error>
    <description>Sector not found</description>
    <code>105</code>
</error>

Примечания

Ответ может содержать ряд новых необязательных параметров, которые важно учесть при составлении подписи.
Запрос поддерживает только проверку паспорта физлица.
Параметр request_id не учитывает последовательностей и просто возвращается как был передан в nonce.