Проверка паспорта
check
Метод Этот запрос нужен, чтобы провести проверку паспортных данных получателя выплаты (физлица).
В ответе возвращается идентификатор запроса, по нему можно узнать результат проверки.
Адрес для отправки запроса
Для тестирования
POST https://kyc-stage.bank131.ru/api/v1.1/check
При тестировании реальная проверка паспортных данных в СМЭВ не производится, результат проверки будет эмулирован. Не используйте проверку на тестовой среде для идентификации клиентов.
Для реальных операциий
POST https://kyc.bank131.ru/api/v1.1/check
Запрос
Параметры запроса
Данные получателя
Название | Обязательность | Тип | Описание |
---|---|---|---|
first_name | + | string | Фамилия |
last_name | + | string | Имя |
patronymic | - | string | Отчество |
birthday | + | string | Дата рождения |
birthplace | + | string | Место рождения |
inn | + | string | ИНН, 10 цифр |
Удостоверение личности (паспорт)
Название | Обязательность | Тип | Описание |
---|---|---|---|
identity_document | + | string | Тип документа. Всегда: Паспорт гражданина РФ |
passport_number | + | string | Серия и номер паспорта, без пробелов. Пример: 1234567890 . |
issuer | + | string | Кем выдан |
issuer_code | + | string | Код подразделения |
issuer_date | + | string | Дата выдачи в формате ДД.ММ.ГГГГ |
citizenship | + | string | Гражданство. Всегда РФ |
Адрес регистрации
Название | Обязательность | Тип | Описание |
---|---|---|---|
postcode | + | string | Индекс |
address | + | string | Адрес |
Контакты получателя
Название | Обязательность | Тип | Описание |
---|---|---|---|
+ | string | Адрес электронной почты (нужен валидный адрес) | |
phone_number | + | string | Номер телефона в любом формате |
Дополнительные данные
Название | Обязательность | Тип | Описание |
---|---|---|---|
agent_contract_number | + | string | Номер агентского договора с получателем |
agent_contract_date | + | string | Дата агентского договора с получателем |
beneficial_owners | + | string | Всегда ВБ отсутствует |
public_officials | + | string | Всегда Нет |
migration_card | + | string | Всегда - |
right_to_stay_in_rf | + | string | Всегда - |
Пример запроса
-H 'x-partner-project: test-partner-project' \
-H 'Content-Type: application/json' \
-H 'accept: application/json' \
--data-binary
'{
"payload":
{
"inn":"065553161159",
"email":"name@email.com",
"issuer":"ОТДЕЛОМ УФМС РОССИИ",
"address":"г. Бобруйск, алл. Прибрежная, д. 53 стр. 9, 365826",
"birthday":"01.01.1970",
"postcode":"365826",
"birthplace":"г. Бобруйск",
"last_name":"Дмитриев",
"first_name":"Иван",
"patronymic":"Герасимович",
"citizenship":"РФ",
"issuer_code":"123-000",
"issuer_date":"01.01.2010",
"phone_number":"+79000000000",
"migration_card":"-",
"passport_number":"0234567890",
"public_officials":"Нет",
"beneficial_owners":"ВБ отсутствует",
"identity_document":"Паспорт гражданина РФ",
"agent_contract_date":"01.01.2020",
"right_to_stay_in_rf":"-",
"agent_contract_number":"123456789-0"
},
"signature":"dkQzYwTExRc0RFWk1CY0dBMVVFQnd3UTBMTXVJTkNjMEw3Ug0NCmd..."}' --compressed
Ответ
При тестировании успех проверки (значение поля
status
в ответе) зависит от последней цифры номера паспорта в полеpassport_number
в запросе.
Последняя цифра passport_number
Значение status
Четный, включая 0 ok
Нечетный error
Параметры ответа
Название | Обязательность | Тип | Описание |
---|---|---|---|
status | + | string | Статус проверки. Возможные варианты: ok , error |
data | - | Data | Объект с данными ответа |
id | - | number | Идентификатор запроса check |
description | - | string | Описание статуса запроса |
error | - | Error | Объект с данными ошибки |
code | + | string | Код ошибки |
description | + | string | Описание ошибки |
Пример успешного ответа
{
"status": "ok",
"data":
{
"id": "7",
"description": "запрос добавлен в очередь"
}
}
Пример ответа с ошибкой
{
"status": "error",
"error": {
"code": "partner_project_not_found",
"description": "partner project not found"
}
}